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bfs(l) big file scanner bfs(l) 

biff server comsat(8C) 

biff(l) be notified if mail biff(l) 

big diff bdiff(l) 

big file scanner bfs(l) 

binaries install(lB) 

binary directories cpset(lM) 

binary, file /find the printable strings(l) 

binary, source, and manual page whereis(l) 

block sync(lM) 

block count of a file sum(l) 

blocks and i-nodes .. df(lM) 

boot procedure boot(8) 
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mknod(lM) 

sized ) print section sizes in 

cc(l) 

cpp(l) the 

cb(l) 

indent (1) indent and format 

xstr(l) extract strings from 

error message file by massaging 

dc(l) desk 
cal(l) print 

an LP line printer lp(l) 

description into a terminfo/ 

for later analysis using/ dump(8) 

text editor (variant of ex for 

catman(8) create the 

files 

cat(lB) 
for the manual 



commentary of an SCCS delta 

chsh(l) 

chfn(l) 

passwd(l) 

chmod(l) 

chown(l) chgrp(l) 

command chroot(lM) 

shutdown(lM) shut down system, 

SCCS delta cdc(l) 

newform(l) 

delta(l) make a delta 

cd(l) 

fgrep(l) search a file for a 

tr(l) translate 

dodisk(lM) lastlogin(lM)/ 

fsck(lM) 

permissions file uucheck(lM) 

grpck(lM) password/group file 

file sum(l) print 

chown(l) 

group 

for a command 

shell 

lastlogin(lM)/ chargefee(lM) 

uucp spool directory 

clri(lM) 

clear(l) 

shell (command interpreter) with 



boot(8) system boot procedure boot(8) 

build special file mknod(lM) 

bytes of common object files size(l) 

C compiler cc(l) 

C language preprocessor cpp(l) 

C program beautifier cb(l) 

C program source indent(l) 

C programs to implement shared/ xstr(l) 

C source mkstr(l) create an mkstr(l) 

cal(l) print calendar cal(l) 

calculator dc(l) 

calendar cal(l) 

calendar(l) reminder service calendar(l) 

cancel(l) send/cancel requests to lp(l) 

captoinfo(lM) convert a termcap captoinfo(lM) 

capture the state of the memory dump(8) 

casual users) edit(l) edit(l) 

cat files for the manual catman(8) 

cat(l) concatenate and print cat(l) 

cat(lB) catenate and print cat (IB) 

catenate and print , cat(lB) 

catman(8) create the cat files catman(8) 

cb(l) C program beautifier cb(l) 

cc(l) C compiler ., cc(l) 

cd(l) change working directory cd(i) 

cdc(l) change the delta cdc(l) 

change default login shell chsh(l) 

change finger entry chfn(l) 

change login password passwd(l) 

change mode chmod(l) 

change owner or group chown(l) 

change root directory for a chroot(lM) 

change system state shutdown(lM) 

change the delta commentary of an cdc(l) 

change the format of a text file newform(l) 

(change) to an SCCS file delta(l) 

change working directory cd(l) 

character string fgrep(l) 

characters tr(l) 

chargefee(lM) ckpacct(lM) chargefee(lM) 

check and repair file systems fsck(lM) 

check the uucp directories and uucheck(lM) 

checkers pwck(lM) pwck(lM) 

checksum and block count of a sum(l) 

chfn(l) change finger entry chfn(l) 

chgrp(l) change owner or group chown(l) 

chmod(l) change mode chmod(l) 

chown(l) chgrp(l) change owner or chown(l) 

chroot(lM) change root directory chroot(lM) 

chsh(l) change default login chsh(l) 

ckpacct(lM) dodisk(lM) chargefee(lM) 

clean-up uucleanup(lM) uucleanup(lM) 

clear i-node clri(lM) 

clear terminal screen clear(l) 

clear(l) clear terminal screen clear(l) 

C-like syntax csh(l) a csh(l) 
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cron(lM) 



CRT previewing 

comb(l) 

common to two sorted files 

nice(l) run a 

change root directory for a 

env(l) set environment for 

quits nohup(l) run a 

syntax csh(l) a shell 

whatis(l) describe what a 

getopt(l) parse 

getopts(l) getoptcvt(l) parse 

/shell, the standard /restricted 

system activity timex(l) time a 

test(l) condition evaluation 

time(l) time a 

uuxqt(lM) execute remote 

accounting records acctcms(lM) 

apply(l) apply a 

and manual page files for a 

argument list(s) and execute 

and/ intro(l) introduction to 

at(l) batch(l) execute 

apropos(l) locate 

order lastcomm(l) show last 

and miscellaneous accounting 

install(lM) install 

environment rc2(lM) run 

operating system rcO(lM) run 

cdc(l) change the delta 

as(l) 

nm(l) print name list of 

line number information from a 

ld(l) link editor for 

print section sizes in bytes of 

comm(l) select or reject lines 

ipcs(l) report inter-process 

the system users(l) 

diff(l) differential file 

differential file and directory 

descriptions infocmp(lM) 

cmp(l) 

file sccsdiff(l) 

diff3(l) 3-way differential file 

dircmp(l) directory 

regcmp(l) regular expression 

cc(l)C 

tic(lM) terminfo 

zic(8) time zone 

error(l) analyze and disperse 

fc(l) Fortran 

yacc(l) yet another 



clock daemon cron(lM) 

clri(lM) clear i-node clri(lM) 

cmp(l) compare two files cmp(l) 

col(l) filter reverse linefeeds col(l) 

colcrt(l) filter nroff output for colcrt(l) 

comb(l) combine SCCS deltas comb(l) 

combine SCCS deltas comb(l) 

comm(l) select or reject lines comm(l) 

command at low priority nice(l) 

command chroot(lM) chroot(lM) 

command execution . env(l) 

command immune to hangups and nohup(l) 

(command interpreter) with C-like csh(l) 

command is . whatis(l) 

command options getopt(l) 

command options getopts(l) 

command programming language sh(l) 

command; report process data and timex(l) 

command . test(l) 

command time(l) 

command requests uuxqt(lM) 

command summary from per-process acctcms(lM) 

command to a set of arguments apply(l) 

command /the binary, source, whereis(l) 

command xargs(l) construct .. xargs(l) 

commands, application programs, intro(l) 

commands at a later time at(l) 

commands by keyword lookup apropos(l) 

commands executed in reverse lastcomm(l) 

commands /overview of accounting acctdisk(lM) 

commands install(lM) 

commands performed for multi-user .. rc2(lM) 

commands performed to stop the rcO(lM) 

commentary of an SCCS delta cdc(l) 

common assembler as(l) 

common object file nm(l) 

common object file /symbol and strip(l) 

common object files ld(l) 

common object files size(l) sized ) 

common to two sorted files comm(l) 

communication facilities status ipcs(l) 

compact list of users who are on users(l) 

comparator diff(l) 

comparator diff(lB) diff(lB) 

compare or print out terminfo infocmp(lM) 

compare two files cmp(l) 

compare two versions of an SCCS sccsdiff(l) 

comparison diff3(l) 

comparison .". dircmp(l) 

compile regcmp(l) 

compiler cc(l) 

compiler tic(lM) 

compiler .........zic(8) 

compiler error messages error(l) 

compiler fc(l) 

compiler-compiler yacc(l) 
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wait(l) await 

compress(l) uncompress(l) zcat(l) 

pack(l) pcat(l) unpack(l) 

compress and expand data 

cat(l) 

test(l) 

mkfarm(lM) 

parameters ifconfig(8C) 

lpadmin(lM) 

fwtmp(lM) wtmpfix(lM) manipulate 

acctconl(lM) acctcon2(lM) 

mkfs(lM) 

execute command xargs(l) 

remove nroff /troff, tbl, and eqn 

debugging on Uutry(lM) try to 

ls(l) list 

csplit(l) 

vc(l) version 

address resolution display and 

init(lM) telinit(lM) process 

pled(lM) 

uadmin(lM) administrative 

units(l) 

into a terminfo/ captoinfo(lM) 

dd(lM) 

cp(lB) 

dd(lM) convert and 

tcopy(l) 

cpio(l) 

cp(l) ln(l) mv(l) 

sum(l) print checksum and block 

wc(l) word 

move files 

out 

preprocessor 

binary directories 

memory for later analysis using 

ctags(l) 

massaging C source mkstr(l) 

admin(l) 

manual catman(8) 

crontab(l) user 

colcrt(l) filter nroff output for 

page(l) file perusal filter for 

pg(l) file perusal filter for 

interpreter) with C-like syntax 



set or print identifier of 
hostname(l) set or print name of 



completion of process wait(l) 

compress and expand data compress(l) 

compress and expand files pack(l) 

compress(l) uncompress(l) zcat(l) compress(l) 

comsat(8C) biff server comsat(8C) 

concatenate and print files cat(l) 

condition evaluation command test(l) 

configure a striped file system mkfarm(lM) 

configure network interface ifconfig(8C) 

configure the LP spooling system lpadmin(lM) 

connect accounting records fwtmp(lM) 

connect-time accounting acctconl(lM) 

construct a file system mkfs(lM) 

construct argument list(s) and xargs(l) 

constructs deroff(l) deroff(l) 

contact remote system with Uutry(lM) 

contents of directory ls(l) 

context split csplit(l) 

control vc(l) 

control arp(8C) arp(8C) 

control initialization init(lM) 

control the front panel LED pled(lM) 

control uadmin(lM) 

conversion program units(l) 

convert a terrncap description captoinfo(lM) 

convert and copy a file dd(lM) 

copy cp(lB) 

copy a file dd(lM) 

copy a mag tape tcopy(l) 

copy file archives in and out cpio(l) 

copy, link or move files cp(l) 

count of a file sum(l) 

count wc(l) 

cp(l) ln(l) mv(l) copy, link or cp(l) 

cp(lB) copy cp(lB) 

cpio(l) copy file archives in and cpio(l) 

cpp(l) the C language cpp(l) 

cpset(lM) install object files in cpset(lM) 

crash(lM) examine system images crash(lM) 

crash(lM) /the state of the dump(8) 

create a tags file ctags(l) 

create an error message file by mkstr(l) 

create and administer SCCS files admin(l) 

create the cat files for the catman(8) 

cron(lM) clock daemon cron(lM) 

crontab file crontab(l) 

crontab(l) user crontab file crontab(l) 

CRT previewing colcrt(l) 

crt viewing more(l) more(l) 

CRTs pg(l) 

crypt(l) encode/decode crypt(l) 

csh(l) a shell (command csh(l) 

csplit(l) context split csplit(l) 

ctags(l) create a tags file ctags(l) 

current host system hostid(l) hostid(l) 

current host system hostname(l) 
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activity sact(l) print 

uname(l) print name of 

whoami(l) print effective 

line of a file cut(l) 

each line of a file 

cron(lM) clock 

gated(8) gateway routing 

nda(lM) network 

routed(8C) network routing 

runacct(lM) run 

Protocol server ftpd(8C) 

telnetd(8C) 

Protocol server tftpd(8C) 

/time a command; report process 

generate disk accounting 

zcat(l) compress and expand 

prof(l) mkprof(l) display profile 

join(l) relational 

a terminal or query terminfo 

date(l) print and set the 



dbg(l) 

fsdb(lM) file system 

try to contact remote system with 

chsh(l) change 

basename(l) dirname(l) 

tail(l) 

the delta commentary of an SCCS 

delta(l) make a 

cdc(l) change the 

rmdel(l) remove a 

an SCCS file 

comb(l) combine SCCS 

mesg(l) permit or 

tset,reset(l) terminal 

tbl, and eqn constructs 

whatis(l) 

description into a terminfo 

captoinfo(lM) convert a termcap 

compare or print out terminfo 

dc(l) 

fstyp(lM) 

file(l) 

lines for finite width output 

devnm(lM) 

blocks and i-nodes 

disk farms and administration 

and administration dfconf(lM) 

dfconf(lM) dflist(lM) 

ratfor(l) rational Fortran 

bdiff(l) big 

comparator 



current SCCS file editing sact(l) 

current UNIX system uname(l) 

current user id whoami(l) 

cut out selected fields of each cut(l) 

cut(l) cut out selected fields of cut(l) 

daemon cron(lM) 

daemon .. gated(8) 

daemon nda(lM) 

daemon routed(8C) 

daily accounting runacct(lM) 

DARPA Internet File Transfer ftpd(8C) 

DARPA TELNET protocol server telnetd(8C) 

DARPA Trivial File Transfer tftpd(8C) 

data and system activity timex(l) 

data by user ID diskusg(lM) diskusg(lM) 

data compress(l) uncompress(l) compress(l) 

data prof(l) 

database operator join(l) 

database tput(l) initialize tput(l) 

date date(l) 

date(l) print and set the date date(l) 

dbg(l) debugger dbg(l) 

dc(l) desk calculator dc(l) 

dd(lM) convert and copy a file dd(lM) 

debugger dbg(l) 

debugger fsdb(lM) 

debugging on Uutry(lM) Uutry(lM) 

default login shell chsh(l) 

deliver portions of path names basename(l) 

deliver the last part of a file tail(l) 

delta cdc(l) change cdc(l) 

delta (change) to an SCCS file delta(l) 

delta commentary of an SCCS delta cdc(l) 

delta from an SCCS file rmdel(l) 

delta(l) make a delta (change) to delta(l) 

deltas comb(l) 

deny messages .,. mesg(l) 

dependent initialization tset,reset(l) 

deroff(l) remove nroff/troff, deroff(l) 

describe what a command is whatis(l) 

description /convert a termcap captoinfo(lM) 

description into a terminfo/ captoinfo(lM) 

descriptions infocmp(lM) infocmp(lM) 

desk calculator dc(l) 

determine file system identifier fstyp(lM) 

determine file type file(l) 

device fold(l) fold long fold(l) 

device name devnm(lM) 

devnm(lM) device name devnm(lM) 

df(lM) report number of free disk df(lM) 

dfconf(lM) dflist(lM) dfreset(lM) dfconf(lM) 

dflist(lM) dfreset(lM) disk farms dfconf(lM) 

dfreset(lM) disk farms and/ dfconf(lM) 

dialect ratfor(l) 

diff bdiff(l) 

diff(l) differential file diff(l) 
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directory comparator 

comparison 

sdiff(l) side-by-side 

comparator diff(lB) 

diff(l) 

diff3(l) 3-way 

mkdir(l) make 

rm(l) rmdir(l) remove files or 

uucheck(lM) check the uucp 

install object files in binary 

link and unlink files and 

cd(l) change working 

uucleanup(lM) uucp spool 

diff(lB) differential file and 

dircmp(l) 

ls(l) list contents of 

chroot(lM) change root 

mvdir(lM) move a 

pwd(l) working 

path names basename(l) 

printers enable(l) 

type, modes, speed, and line 

type, modes, speed, and line 

diskusg(lM) generate 

df(lM) report number of free 

dfconf(lM) dflist(lM) dfreset(lM) 

du(lM) summarize 

dvhtool(lM) modify 

accounting data by user ID 

error (1) analyze and 

arp(8C) address resolution 

vi(l) screen-oriented (visual) 

variables nvram(lM) 

prof(l) mkprof(l) 

screendump(l) dump the screen 

install all software 

chargefee(lM) ckpacct(lM) 

w(l) who is on and what they are 

whodo(lM) who is 

named (8) Internet 

hd(l) hexadecimal and ASCII 

od(l) octal 

screendump(l) 

memory for later analysis using/ 

zdump(8) time zone 

header information 

echo(l) 

hosts ping(8) send ICMP 

ex for casual users) 

sact(l) print current SCCS file 

screen-oriented (visual) display 

ed(l) red(l) text 



diff(lB) differential file and diff(lB) 

diff3(l) 3-way differential file diff3(l) 

difference program sdiff(l) 

differential file and directory diff(lB) 

differential file comparator diff(l) 

differential file comparison diff3(l) 

dircmp(l) directory comparison dircmp(l) 

directories mkdir(l) 

directories rm(l) 

directories and permissions file uucheck(lM) 

directories cpset(lM) cpset(lM) 

directories link(lM) unlink(lM) link(lM) 

directory cd(l) 

directory clean-up uucleanup(lM) 

directory comparator diff(lB) 

directory comparison dircmp(l) 

directory ls(l) 

directory for a command chroot(lM) 

directory mvdir(lM) 

directory name pwd(l) 

dirname(l) deliver portions of basename(l) 

disabled) enable/disable LP enable(l) 

discipline /set terminal getty(lM) 

discipline /set terminal uugetty(lM) 

disk accounting data by user ID diskusg(lM) 

disk blocks and i-nodes df(lM) 

disk farms and administration dfconf(lM) 

disk usage du(lM) 

disk volume header information dvhtool(lM) 

diskusgdM) generate disk diskusg(lM) 

disperse compiler error messages error(l) 

display and control arp(8C) 

display editor based on ex vi(l) 

display or set values of NVRAM nvram(lM) 

display profile data prof(l) 

display screendump(l) 

distribution tapes installpkg(l) installpkg(l) 

dodisk(lM) lastlogin(lM)/ chargefee(lM) 

doing w(l) 

doing what whodo(lM) 

domain name server named(8) 

du(lM) summarize disk usage du(lM) 

dump hd(l) 

dump od(l) 

dump the screen display screendump(l) 

dump(8) capture the state of the dump(8) 

dumper zdump(8) 

dvhtool(lM) modify disk volume dvhtool(lM) 

echo arguments echo(l) 

echo(l) echo arguments echo(l) 

ECHO_REQUEST packets to network ping(8) 

ed(l) red(l) text editor ed(l) 

edit(l) text editor (variant of edit(l) 

editing activity sact(l) 

editor based on ex vi(l) vi(l) 

editor ed(l) 
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ex(l) text 

ld(l) link 

sed(l) stream 

users) edit(l) text 

whoami(l) print 

pattern using full regular/ 

enable/disable LP printers 

enabled) disable(l) 

crypt(l) 

makekey(l) generate 

sccs(l) front 

logger (1) make 

chfn(l) change finger 

command execution 

env(l) set 

printenv(l) print out the 

commands performed for multi-user 

remove nroff/troff, tbl, and 

source mkstr(l) create an 

analyze and disperse compiler 

compiler error messages 

hashcheck(l) find spelling 

setmnt(lM) 

expression expr(l) 

test(l) condition 

edit(l) text editor (variant of 

(visual) display editor based on 

crash(lM) 

construct argument list(s) and 

at(l) batch(l) 

uuxqt(lM) 

lastcomm(l) show last commands 

set environment for command 

sleep(l) suspend 

zcat(l) compress and 

pcat(l) unpack(l) compress and 

versa expand(l) unexpand(l) 

to spaces, and vice versa 

expression 

regcmp(l) regular 

expr(l) evaluate arguments as an 

for a pattern using full regular 

to implement shared/ xstr(l) 

inter-process communication 

factors of a number 

f actor (1) obtain the prime 

trued ) 

/dflist(lM) dfreset(lM) disk 

head(l) give first 

character string 

cut(l) cut out selected 

diff(lB) differential 

tar(l) tape 

cpio(l) copy 



editor ex(l) 

editor for common object files ld(l) 

editor sed(l) 

editor (variant of ex for casual edit(l) 

effective current user id whoami(l) 

egrep(l) search a file for a egrep(l) 

enabled) disabled) enable(l) 

enable/disable LP printers enable(l) 

encode/decode crypt(l) 

encryption key makekey(l) 

end for the SCCS subsystem sccs(l) 

entries in the system log logger(l) 

entry , chfn(l) 

env(l) set environment for env(l) 

environment for command execution env(l) 

environment printenv(l) 

environment rc2(lM) run rc2(lM) 

eqn constructs deroffd) deroff(l) 

error message file by massaging C mkstr(l) 

error messages error(l) error(l) 

error(l) analyze and disperse error(l) 

errors /hashmake(l) spellin(l) spell(l) 

establish mount table setmnt(lM) 

evaluate arguments as an expr(l) 

evaluation command test(l) 

ex for casual users) edit(l) 

ex vi(l) screen-oriented vi(l) 

ex(l) text editor ex(l) 

examine system images . crash(lM) 

execute command xargs(l) xargs(l) 

execute commands at a later time at(l) 

execute remote command requests uuxqt(lM) 

executed in reverse order lastcomm(l) 

execution env(l) env(l) 

execution for an interval sleep(l) 

expand data /uncompress(l) compress(l) 

expand files pack(l) pack(l) 

expand tabs to spaces, and vice . expand(l) 

expand(l) unexpand(l) expand tabs expand(l) 

expr(l) evaluate arguments as an expr(l) 

expression compile regcmp(l) 

expression expr(l) 

expressions /search a file egrep(l) 

extract strings from C programs xstr(l) 

facilities status ipcs(l) report ipcs(l) 

factor(l) obtain the prime factor(l) 

factors of a number , factor(l) 

false(l) provide truth values true(l) 

farms and administration dfconf(lM) 

fc(l) Fortran compiler fc(l) 

few lines head(l) 

fgrep(l) search a file for a fgrep(l) 

fields of each line of a file cut(l) 

file and directory comparator diff(lB) 

file archiver tar(l) 

file archives in and out cpio(l) 
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mkstr(l) create an error message file by massaging C source mkstr(l) 

pwck(lM) grpck(lM) password/group file checkers pwck(lM) 

dd(lM) convert and copy a file dd(lM) 

mknod(lM) build special file mknod(lM) 

diff(l) differential file comparator diff(l) 

diff3(l) 3-way differential file comparison diff3(l) 

crontab(l) user crontab file crontab(l) 

ctags(l) create a tags file . ctags(l) 

selected fields of each line of a file cut(l) cut out cut(l) 

make a delta (change) to an SCCS file delta(l) delta(l) 

sact(l) print current SCCS file editing activity sact(l) 

fgrep(l) search a file for a character string .. . fgrep(l) 

grep(l) search a file for a pattern . grep(l) 

regular/ egrep(l) search a file for a pattern using full egrep(l) 

fpr(l) asa(l) print Fortran file fpr(l) 

get(l) get a version of an SCCS file get(l) 

which(l) locate a program file including aliases and paths which(l) 

/split a multi-routine Fortran file into individual files fsplit(l) 

split(l) split a file into pieces split(l) 

make names local to an object file localize(l) localize(l) 

change the format of a text file newform(l) newform(l) 

print name list of common object file nm(l) nm(l) 

files or subsequent lines of one file /merge same lines of several paste(l) 

identify processes using a file or file structure fuser(lM) fuser(lM) 

viewing more(l) page(l) file perusal filter for crt more(l) 

pg(l) file perusal filter for CRTs pg(l) 

prs(l) print an SCCS file prs(l) 

rev(l) reverse lines of a file rev(l) 

remove a delta from an SCCS file rmdel(l) rmdel(l) 

bfs(l) big file scanner bfs(l) 

compare two versions of an SCCS file sccsdiff(l) sccsdiff(l) 

in an object, or other binary, file /find the printable strings strings(l) 

processes using a file or file structure /identify fuser(lM) 

information from a common object file /symbol and line number strip(l) 

checksum and block count of a file sum(l) print sum(l) 

fsdb(lM) file system debugger fsdb(lM) 

fstyp(lM) determine file system identifier fstyp(lM) 

mkfarm(lM) configure a striped file system mkfarm(lM) 

mkfs(lM) construct a file system mkfs(lM) 

fsstat(lM) report file system status fsstat(lM) 

/umount(lM) mount and unmount file systems and remote resources mount(lM) 

fsck(lM) check and repair file systems fsck(lM) 

labelit(lM) provide labels for file systems labelit(lM) 

mount, unmount multiple file systems /umountall(lM) mountall(lM) 

deliver the last part of a file tail(l) tail(l) 

adapt(l) postload an a.out file to run on a Stardent 3000 adapt(l) 

and modification times of a file touch(l) update access touch(l) 

ftpd(8C) DARPA Internet File Transfer Protocol server ftpd(8C) 

tftpd(8C) DARPA Trivial File Transfer Protocol server tftpd(8C) 

uucp system uucico(lM) file transport program for the uucico(lM) 

/the scheduler for the uucp file transport program uusched(lM) 

file(l) determine file type file(l) 

undo a previous get of an SCCS file unget(l) unget(l) 

report repeated lines in a file uniq(l) uniq(l) 

val(l) validate SCCS file val(l) 

uucp directories and permissions file uucheck(lM) check the uucheck(lM) 
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umask(l) set 

and print process accounting 

merge or add total accounting 

create and administer SCCS 

cat(l) concatenate and print 

cmp(l) compare two 

unlink(lM) link and unlink 

reject lines common to two sorted 

ln(l) mv(l) copy, link or move 

find(l) find 

binary, source, and manual page 

catman(8) create the cat 

cpset(lM) install object 

Fortran file into individual 

link editor for common object 

rm(l) rmdir(l) remove 

file /merge same lines of several 

unpack(l) compress and expand 

pr(l) print 

sizes in bytes of common object 

sort(l) sort and /or merge 

what(l) identify SCCS 

more(l) paged ) file perusal 

pg(l) file perusal 

nl(l) line numbering 

previewing colcrt(l) 

col(l) 

find(l) 

look(l) 

keywords; print out the/ man(l) 

spellin(l) hashcheck(l) 

object, or other/ strings(l) 

chfn(l) change 

program 

fold(l) fold long lines for 

teed) pipe 

output device fold(l) 

finite width output device 

indent(l) indent and 

newform(l) change the 

fed) 

ratfor(l) rational 

fpr(l) asa(l) print 

fsplit(l) split a multi-routine 

df(lM) report number of 
from(l) who is my mail 

sccs(l) 

pled(lM) control the 

systems 

Fortran file into individual/ 
status 



filed) determine file type filed) 

file-creation mode mask umask(l) 

file(s) acctcom(l) search acctcom(l) 

files acctmerg(lM) acctmerg(lM) 

files admin(l) admin(l) 

files cat(l) 

files empd) 

files and directories link(lM) linkdM) 

files comm(l) select or comm(l) 

files cpd) • cpd) 

files find(l) 

files for a command /locate the whereis(l) 

files for the manual catman(8) 

files in binary directories cpset(lM) 

files /split a multi-routine fsplit(l) 

files ld(l) ld(l) 

files or directories rm(l) 

files or subsequent lines of one pasted) 

files pack(l) pcat(l) pack(l) 

files pr(l) 

files sized) print section sized) 

files sort(l) 

files what(l) 

filter for crt viewing more(l) 

filter for CRTs . pg(l) 

filter nld) 

filter nroff output for CRT colcrt(l) 

filter reverse line-feeds cold) 

find files find(l) 

find lines in a sorted list look(l) 

find manual information by man(l) 

find spelling errors /hashmake(l) spell(l) 

find the printable strings in an strings(l) 

find(l) find files find(l) 

finger entry chfn(l) 

finger(l) user information lookup finger(l) 

finite width output device fold(l) 

fitting teed) 

fold long lines for finite width fold(l) 

fold(l) fold long lines for fold(l) 

format C program source indent(l) 

format of a text file newform(l) 

Fortran compiler fed) 

Fortran dialect ratfor(l) 

Fortran file fpr(l) 

Fortran file into individual/ fsplit(l) 

fpr(l) asa(l) print Fortran file fpr(l) 

free disk blocks and i-nodes df(lM) 

from? fromd) 

from(l) who is my mail from? fromd) 

front end for the SCCS subsystem sccs(l) 

front panel LED pled(lM) 

fsck(lM) check and repair file fsck(lM) 

fsdb(lM) file system debugger fsdb(lM) 

fsplit(l) split a multi-routine fsplit(l) 

fsstat(lM) report file system fsstat(lM) 
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identifier 

Transfer Protocol server 

/search a file for a pattern using 

using a file or file structure 

connect accounting records 

gated(8) 

user ID diskusg(lM) 

makekey(l) 

i-numbers ncheck(lM) 

lexical tasks lex(l) 

mklist(l) PostScript label 

file 

options getopts(l) 

command options 

modes, speed, and line/ 

head(l) 

pattern 

vgrind(l) 

chown(l) chgrp(l) change owner or 

id(lM) print user and 

newgrp(lM) log in to a new 

maintain, update, and regenerate 

checkers pwck(lM) 

nohup(l) run a command immune to 

spell(l) hashmake(l) spellin(l) 

hashcheck(l) find/ spell(l) 



dvhtool(lM) modify disk volume 
help(l) ask for 

sees 

hd(l) 

or print identifier of current 

set or print name of current 

of current host system 

current host system 

ECHO_REQUEST packets to network 

network hosts ping(8) send 

disk accounting data by user 

semaphore set or shared memory 

print effective current user 

and names 

fstyp(lM) determine file system 

hostid(l) set or print 

or file structure fuser(lM) 

what(l) 

id(lM) print user and group 

interface parameters 

unifdef(l) remove 

crash(lM) examine system 

nohup(l) run a command 

strings from C programs to 

which(l) locate a program file 



fstyp(lM) determine file system fstyp(lM) 

ftpd(8C) DARPA Internet File ftpd(8C) 

full regular expressions egrep(l) 

fuser(lM) identify processes fuser(lM) 

fwtmp(lM) wtmpfix(lM) manipulate fwtmp(lM) 

gated(8) gateway routing daemon gated(8) 

gateway routing daemon gated(8) 

generate disk accounting data by diskusg(lM) 

generate encryption key makekey(l) 

generate path names from ncheck(lM) 

generate programs for simple lex(l) 

generator mklist(l) 

get(l) get a version of an SCCS get(l) 

getopt(l) parse command options getopt(l) 

getoptcvt(l) parse command getopts(l) 

getopts(l) getoptcvt(l) parse getopts(l) 

getty(lM) set terminal type, getty(lM) 

give first few lines head(l) 

grep(l) search a file for a grep(l) 

grind nice listings of programs vgrind(l) 

group chown(l) 

group IDs and names id(lM) 

group newgrp(lM) 

groups of programs make(l) make(l) 

grpck(lM) password /group file pwck(lM) 

halt(8) stop the processor halt(8) 

hangups and quits nohup(l) 

hashcheck(l) find spelling errors spell(l) 

hashmake(l) spellin(l) spell(l) 

hd(l) hexadecimal and ASCII dump hd(l) 

head(l) give first few lines head(l) 

header information dvhtool(lM) 

help regarding SCCS help(l) 

help(l) ask for help regarding help(l) 

hexadecimal and ASCII dump hd(l) 

host system hostid(l) set hostid(l) 

host system hostname(l) hostname(l) 

hostid(l) set or print identifier hostid(l) 

hostname(l) set or print name of hostname(l) 

hosts ping(8) send ICMP ping(8) 

ICMP ECHO_REQUEST packets to ping(8) 

ID diskusg(lM) generate diskusg(lM) 

id /remove a message queue, ipcrm(l) 

id whoami(l) whoami(l) 

id(lM) print user and group IDs id(lM) 

identifier fstyp(lM) 

identifier of current host system hostid(l) 

identify processes using a file fuser(lM) 

identify SCCS files what(l) 

IDs and names id(lM) 

ifconfig(8C) configure network ifconfig(8C) 

ifdefed lines unifdef(l) 

images crash(lM) 

immune to hangups and quits nohup(l) 

implement shared strings /extract xstr(l) 

including aliases and paths which(l) 
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source indent(l) 

program source 

very_long_name to/ makeindex(8) 

teletypes last(l) 

return I am on vacation 

a multi-routine Fortran file into 

terminfo descriptions 

out the/ man(l) find manual 

modify disk volume header 

/strip symbol and line number 

finger(l) user 

Ipstat(l) print LP status 

vers(l) obtain version 

control initialization 

telinit(lM) process control 

bcheckrc(l) system 

tset,reset(l) terminal dependent 

terminfo database tput(l) 

clri(lM) clear 

number of free disk blocks and 

tapes installpkg(l) 

install(lB) 

install(lM) 

directories cpset(lM) 



software distribution tapes 

system mailx(l) 

nslookup(l) query name servers 

swap(lM) swap administrative 

ifconfig(8C) configure network 

named(8) 

sendmail(8) send mail over the 

server ftpd(8C) DARPA 

inetd(8) 

csh(l) a shell (command 

facilities status ipcs(l) report 

sleep(l) suspend execution for an 

commands, application programs,/ 

maintenance procedures 

application programs,/ intro(l) 

maintenance procedures intro(8) 

generate path names from 

semaphore set or shared memory/ 

communication facilities status 

news(l) print news 

operator 

makekey(l) generate encryption 

apropos(l) locate commands by 

man(l) find manual information by 

killall(lM) 

processes 

mklist(l) PostScript 

ansitape(l) ANSI-standard magtape 



indent and format C program indent(l) 

indent(l) indent and format C indent(l) 

index manpages allowing man .. makeindex(8) 

indicate last logins of users and last(l) 

indication vacation(l) vacation(l) 

individual files fsplit(l) split fsplit(l) 

inetd(8) internet super-server inetd(8) 

infocmp(lM) compare or print out infocmp(lM) 

information by keywords; print man(l) 

information dvhtool(lM) dvhtool(lM) 

information from a common object/ strip(l) 

information lookup program finger(l) 

information lpstat(l) 

information vers(l) 

init(lM) telinit(lM) process init(lM) 

initialization init(lM) init(lM) 

initialization procedures bcheckrc(l) 

initialization tset,reset(l) 

initialize a terminal or query tput(l) 

i-node clri(lM) 

i-nodes df(lM) report df(lM) 

install all software distribution installpkg(l) 

install binaries installflB) 

install commands install(lM) 

install object files in binary cpset(lM) 

install(lB) install binaries install(lB) 

install(lM) install commands install(lM) 

installpkg(l) install all .. installpkg(l) 

interactive message processing mailx(l) 

interactively nslookup(l) 

interface swap(lM) 

interface parameters ifconfig(8C) 

Internet domain name server named(8) 

internet sendmail(8) 

Internet File Transfer Protocol ftpd(8C) 

internet super-server inetd(8) 

interpreter) with C-like syntax csh(l) 

inter-process communication ipcs(l) 

interval sleep(l) 

intro(l) introduction to . intro(l) 

intro(8) introduction to system intro(8) 

introduction to commands, intro(l) 

introduction to system intro(8) 

i-numbers ncheck(lM) ncheck(lM) 

ipcrm(l) remove a message queue, ipcrm(l) 

ipcs(l) report inter-process ipcs(l) 

items news(l) 

join(l) relational database join(l) 

key ; makekey(l) 

keyword lookup apropos(l) 

keywords; print out the manual man(l) 

kill all active processes killall(lM) 

kill(l) terminate a process kill(l) 

killall(lM) kill all active killall(lM) 

label generator mklist(l) 

label program ansitape(l) 
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file systems 

labelit(lM) provide 

pattern scanning and processing 

arbitrary-precision arithmetic 

pattern scanning and processing 

cpp(l) the C 

command programming 

users and teletypes 

executed in reverse order 

/ckpacct(lM) dodisk(lM) 

/the state of the memory for 

batch(l) execute commands at a 

object files 

remind you when you have to 

to leave 

pled(lM) control the front panel 

simple lexical tasks 

generate programs for simple 

archives ar(l) archive and 

line(l) read one 

terminal type, modes, speed, and 

terminal type, modes, speed, and 

common/ strip(l) strip symbol and 

nl(l) 
cut out selected fields of each 
send /cancel requests to an LP 

col(l) filter reverse 

comm(l) select or reject 

device fold(l) fold long 

head(l) give first few 

uniq(l) report repeated 

look(l) find 

rev(l) reverse 

of several files or subsequent 

subsequent/ paste(l) merge same 

unifdef(l) remove ifdefed 

directories link(lM) unlink(lM) 

files ld(l) 

cp(l) ln(l) mv(l) copy, 

unlink files and directories 

ls(l) 

look(l) find lines in a sorted 

nm(l) print name 

system users(l) compact 

vgrind(l) grind nice 

xargs(l) construct argument 

files cp(l) 

localized) make names 

an object file 

aliases and paths which(l) 

apropos(l) 

manual page files for/ whereis(l) 

newgrp(lM) 

make entries in the system 

syslogd(8) 



labelit(lM) provide labels for labelit(lM) 

labels for file systems labelit(lM) 

language awk(l) ■ awk(l) 

language bc(l) bc(l) 

language oawk(l) oawk(l) 

language preprocessor cpp(l) 

language /the standard /restricted sh(l) 

last(l) indicate last logins of last(l) 

lastcomm(l) show last commands lastcomm(l) 

lastlogin(lM) monacct(lM)/ chargefee(lM) 

later analysis using crash(lM) dump(8) 

later time at(l) at(l) 

ld(l) link editor for common ld(l) 

leave leave(l) leave(l) 

leaved) remind you when you have leaved) 

LED pled(lM) 

lex(l) generate programs for lex(l) 

lexical tasks lex(l) lex(l) 

library maintainer for portable ar(l) 

line lined) 

line discipline getty(lM) set getty(lM) 

line discipline uugetty(lM) set uugetty(lM) 

line number information from a strip(l) 

line numbering filter nl(l) 

line ui a llie Cuivi/ «-ulIvx/ 

line printer lp(l) cancel(l) lpd) 

lined) read one line lined) 

line-feeds cold) 

lines common to two sorted files comm(l) 

lines for finite width output fold(l) 

lines head(l) 

lines in a file uniq(l) 

lines in a sorted list look(l) 

lines of a file rev(l) 

lines of one file /same lines pasted) 

lines of several files or pasted) 

lines unifdef(l) 

link and unlink files and link(lM) 

link editor for common object ld(l) 

link or move files cp(l) 

link(lM) unlink(lM) link and link(lM) 

list contents of directory ls(l) 

list look(l) 

list of common object file nm(l) 

list of users who are on the users(l) 

listings of programs vgrind(l) 

list(s) and execute command xargs(l) 

ln(l) mv(l) copy, link or move cp(l) 

local to an object file localized) 

localized) make names local to localized) 

locate a program file including which(l) 

locate commands by keyword lookup apropos(l) 

locate the binary, source, and whereis(l) 

log in to a new group newgrp(lM) 

log logger(l) logger(l) 

log systems messages syslogd(8) 
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system log logger(l) make entries in the logger(l) 

logname(l) get login name logname(l) 

passwd(l) change login password passwd(l) 

rlogind(8C) remote login server rlogind(8C) 

chsh(l) change default login shell chsh(l) 

login(l) sign on login(l) 

last(l) indicate last logins of users and teletypes last(l) 

logname(l) get login name logname(l) 

list look(l) find lines in a sorted look(l) 

locate commands by keyword lookup apropos(l) apropos(l) 

finger(l) user information lookup program finger(l) 

nice(l) run a command at low priority nice(l) 

send/cancel requests to an LP line printer lp(l) cancel(l) lp(l) 

disabled) enable/disable LP printers enabled) enabled) 

reject(lM) allow or prevent LP requests acceptdM) accept(lM) 

/lpmove(lM) start/stop the LP scheduler and move requests IpscheddM) 

lpadmin(lM) configure the LP spooling system Ipadmin(lM) 

lpstat(l) print LP status information lpstat(l) 

requests to an LP line printer lp(l) cancel(l) send/cancel lp(l) 

spooling system Ipadmin(lM) configure the LP lpadmin(lM) 

scheduler/ lpsched(lM) lpshut(lM) lpmove(lM) start/stop the LP lpsched(lM) 

start/stop the LP scheduler and/ lpsched(lM) lpshut(lM) lpmove(lM) IpscheddM) 

the LP scheduler and/ IpscheddM) lpshut(lM) Ipmove(lM) start/stop IpscheddM) 

information Ipstat(l) print LP status lpstat(l) 

lsd) list contents of directory ls(l) 

m4d) macro processor m4d) 

machid(l) titan(l) mips(l) m68000(l) pdpll(l) u3b(l) u3b2(l)/ machid(l) 

m68000(l) pdpll(l) u3b(l)/ machid(l) titan(l) mips(l) machid(l) 

m4(l) macro processor m4(l) 

tcopyd) copy a mag tape tcopy(l) 

program mt(l) magnetic tape manipulating mt(l) 

ansitape(l) ANSI-standard magtape label program ansitape(l) 

biff(l) be notified if mail arrives and who it is from biff(l) 

from(l) who is my mail from? from(l) 

prmail(l) print out mail in the post office prmail(l) 

send mail to users or read mail mail(l) rmail(l) mail(l) 

sendmail(8) send mail over the internet sendmail(8) 

mail(l) rmail(l) send mail to users or read mail mail(l) 

users or read mail mail(l) rmail(l) send mail to mail(l) 

processing system mailx(l) interactive message mailx(l) 

groups of programs make(l) maintain, update, and regenerate make(l) 

ar(l) archive and library maintainer for portable archives ar(l) 

intro(8) introduction to system maintenance procedures intro(8) 

regenerate groups of programs make(l) maintain, update, and make(l) 

allowing man very_long_name to/ makeindex(8) index manpages makeindex(8) 

key makekey(l) generate encryption makekey(l) 

keywords; print out the manual man(l) find manual information by man(l) 

records fwtmp(lM) wtmpfix(lM) manipulate connect accounting fwtmp(lM) 

route(8C) manually manipulate the routing tables route(8C) 

mt(l) magnetic tape manipulating program mt(l) 

makeindex(8) index manpages allowing man/ makeindex(8) 

create the cat files for the manual catman(8) catman(8) 

print out the manual man(l) find manual information by keywords; man(l) 

by keywords; print out the manual /find manual information man(l) 

/locate the binary, source, and manual page files for a command whereis(l) 

tables route(8C) manually manipulate the routing route(8C) 
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umask(l) set file-creation mode 
create an error message file by 

dump(8) capture the state of the 

queue, semaphore set or shared 
sort(l) sort and /or 
files acctmerg(lM) 

or subsequent lines of/ paste(l) 

source mkstr(l) create an error 

mailx(l) interactive 

shared memory/ ipcrm(l) remove a 

syslogd(8) log systems 

and disperse compiler error 

mesg(l) permit or deny 

u3b2(l)/ machid(l) titan(l) 

/overview of accounting and 

file system 

generator 

prof(l) 

file by massaging C source 

chmod(l) change 

umask(l) set file-creation 

pal(l) turn on/off PAL video 

rsl70(l) turn on/off rsl70 video 

getty(lM) set terminal type, 

uugetty(lM) set terminal type, 

touch(l) update access and 

information dvhtool(lM) 

/dodisk(lM) lastlogin(lM) 

filter for crt viewing 

and remote/ mount(lM) umount(lM) 

setmnt(lM) establish 

mountall(lM) umountall(lM) 

unmount file systems and remote/ 

unmount multiple file systems 

mvdir(lM) 

cp(l) ln(l) mv(l) copy, link or 

start /stop the LP scheduler and 

program 

/umountall(lM) mount, unmount 

individual/ fsplit(l) split a 

run commands performed for 

cp(l) ln(l) 

devnm(lM) device 

nm(l) print 

logname(l) get login 

hostname(l) set or print 

uname(l) print 

tty(l) get the 

pwd(l) working directory 

named® Internet domain 

nslookup(l) query 



mask umask(l) 

massaging C source mkstr(l) mkstr(l) 

memory for later analysis using/ dump(8) 

memory id /remove a message ipcrm(l) 

merge files sort(l) 

merge or add total accounting acctmerg(lM) 

merge same lines of several files paste(l) 

mesg(l) permit or deny messages mesg(l) 

message file by massaging C mkstr(l) 

message processing system mailx(l) 

message queue, semaphore set or ipcrm(l) 

messages syslogd(8) 

messages error(l) analyze error(l) 

messages mesg(l) 

mips(l) m68000(l) pdpll(l) u3b(l) machid(l) 

miscellaneous accounting commands acctdisk(lM) 

mkdir(l) make directories mkdir(l) 

mkfarm(lM) configure a striped mkfarm(lM) 

mkfs(lM) construct a file system mkfs(lM) 

mklist(l) PostScript label mklist(l) 

mknod(lM) build special file mknod(lM) 

mkprof(l) display profile data prof(l) 

mkstr(l) create an error message mkstr(l) 

mode chmod(l) 

mode mask umask(l) 

mode pal(l) 

mode rsl70(l) 

modes, speed, and line discipline getty(lM) 

modes, speed, and line discipline uugetty(lM) 

modification times of a file touch(l) 

modify disk volume header dvhtool(lM) 

monacct(lM) nulladm(lM)/ chargefee(lM) 

more(l) page(l) file perusal more(l) 

mount and unmount file systems mount(lM) 

mount table setmnt(lM) 

mount, unmount multiple file/ mountall(lM) 

mount(lM) umount(lM) mount and mount(lM) 

mountall(lM) umountall(lM) mount, mountall(lM) 

move a directory mvdir(lM) 

move files cp(l) 

move requests /lpmove(lM) lpsched(lM) 

mt(l) magnetic tape manipulating mt(l) 

multiple file systems mountall(lM) 

multi-routine Fortran file into fsplit(l) 

multi-user environment rc2(lM) rc2(lM) 

mv(l) copy, link or move files cp(l) 

mvdir(lM) move a directory mvdir(lM) 

name devnm(lM) 

name list of common object file nm(l) 

name logname(l) 

name of current host system hostname(l) 

name of current UNIX system uname(l) 

name of the terminal tty(l) 

name pwd(l) 

name server named(8) 

name servers interactively nslookup(l) 
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server 

deliver portions of path 

ncheck(lM) generate path 

print user and group IDs and 

localized) make 

from i-numbers 



nda(lM) 

send ICMP ECHO_REQUEST packets to 

ifconfig(8C) configure 

routed(8C) 

netstat(l) show 

text file 

news(l) print 

vgrind(l) grind 
priority 

object file 

hangups and quits 

it is from biff(l) be 

colcrt(l) filter 

constructs deroff(l) remove 

interactively 

/lastlogin(lM) monacct(lM) 

obtain the prime factors of a 

strip(l) strip symbol and line 

i-nodes df(lM) report 

nKDline 

display or set values of 

of NVRAM variables 

processing language 

make names local to an 

nm(l) print name list of common 

number information from a common 

ld(l) link editor for common 

directories cpset(lM) install 

section sizes in bytes of common 

/find the printable strings in an 

number f actor (1) 

vers(l) 

od(l) 

print out mail in the post 

pal(l) turn 

rsl70(l) turn 

commands performed to stop the 

join(l) relational database 

stty(lB) set terminal 

stty(l) set the 

getopt(l) parse command 

getoptcvt(l) parse command 

last commands executed in reverse 

fold long lines for finite width 



named(8) Internet domain name named(8) 

names basename(l) dirname(l) basename(l) 

names from i-numbers ncheck(lM) 

names id(lM) id(lM) 

names local to an object file localized) 

ncheck(lM) generate path names ncheck(lM) 

nda(lM) network daemon nda(lM) 

netstat(l) show network status netstat(l) 

network daemon nda(lM) 

network hosts ping(8) . ping(8) 

network interface parameters ifconfig(8C) 

network routing daemon routed(8C) 

network status netstat(l) 

newform(l) change the format of a newform(l) 

newgrp(lM) log in to a new group newgrp(lM) 

news items news(l) 

news(l) print news items news(l) 

nice listings of programs vgrind(l) 

nice(l) run a command at low nice(l) 

nl(l) line numbering filter nl(l) 

nm(l) print name list of common nm(l) 

nohup(l) run a command immune to nohup(l) 

notified if mail arrives and who biff(l) 

nroff output for CRT previewing colcrt(l) 

nroff/troff, tbl, and eqn deroff(l) 

nslookupd) query name servers nslookup(l) 

nulladm(lM) prctmp(lM)/ chargefee(lM) 

number factor(l) factor(l) 

number information from a common/ strip(l) 

number of free disk blocks and df(lM) 

numbering filter nl(l) 

NVRAM variables nvram(lM) nvram(lM) 

nvram(lM) display or set values nvram(lM) 

oawk(l) pattern scanning and oawk(l) 

object file localized) localized) 

object file ., nm(l) 

object file /symbol and line strip(l) 

object files ld(l) 

object files in binary cpset(lM) 

object files size(l) print sized) 

object, or other binary, file strings(l) 

obtain the prime factors of a factor(l) 

obtain version information vers(l) 

octal dump odd) 

od(l) octal dump od(l) 

office prmail(l) prmail(l) 

on /off PAL video mode paid) 

on/off rsl70 video mode rsl70(l) 

operating system rcO(lM) run rcO(lM) 

operator join(l) 

options stty(lB) 

options for a terminal stty(l) 

options getopt(l) 

options getopts(l) getopts(l) 

order lastcomm(l) show lastcomm(l) 

output device fold(l) fbld(l) 
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colcrt(l) filter nroff 

/accton(lM) acctwtmp(lM) 

chown(l) chgrp(l) change 

compress and expand files 

sadc(lM) system activity report 

ping(8) send ICMP ECHO_REQUEST 

the binary, source, and manual 

pagesize(l) print system 

crt viewing more(l) 

size 

pal(l) turn on/off 

pled(lM) control the front 

configure network interface 

getopt(l) 

getopts(l) getoptcvt(l) 

tail(l) deliver the last 

passwd(l) change login 

pwck(lM) grpck(lM) 

several files or subsequent/ 

dirname(l) deliver portions of 

ncheck(lM) generate 

file including aliases and 

grep(l) search a file for a 

language awk(l) 

language oawk(l) 

egrep(l) search a file for a 

expand files pack(l) 

/titan(l) mips(l) m68000(l) 

environment rc2(lM) run commands 

system rcO(lM) run commands 

check the uucp directories and 

mesg(l) 

acctcms(lM) command summary from 

more(l) paged ) file 

pg(l) file 

CRTs 

split (1) split a file into 

packets to network hosts 

tee(l) 

LED 

and library maintainer for 

basename(l) dirname(l) deliver 

prmail(l) print out mail in the 

banner (1) make 

a Stardent 3000 adapt(l) 

mklist(l) 

/monacct(lM) nulladm(lM) 

/nulladm(lM) prctmp(lM) 

cpp(l) the C language 

accept(lM) reject(lM) allow or 

filter nroff output for CRT 

unget(l) undo a 

fact or (1) obtain the 



output for CRT previewing colcrt(l) 

overview of accounting and/ acctdisk(lM) 

owner or group chown(l) 

pack(l) pcat(l) unpack(l) pack(l) 

package sal(lM) sa2(lM) sal(lM) 

packets to network hosts ping(8) 

page files for a command /locate whereis(l) 

page size pagesize(l) 

page(l) file perusal filter for more(l) 

pagesize(l) print system page pagesize(l) 

PAL video mode pal(l) 

pal(l) turn on/off PAL video mode pal(l) 

panel LED pled(lM) 

parameters ifconfig(8C) ifconfig(8C) 

parse command options getopt(l) 

parse command options getopts(l) 

part of a file tail(l) 

passwd(l) change login password passwd(l) 

password passwd(l) 

password/group file checkers pwck(lM) 

pasted) merge same lines of pasted) 

pathnames basename(l) basename(l) 

path names from i-numbers ncheck(lM) 

paths which(l) locate a program which(l) 

pattern grep(l) 

pattern scanning and processing awk(l) 

pattern scanning and processing oawk(l) 

pattern using full regular/ egrep(l) 

pcat(l) unpack(l) compress and pack(l) 

pdpll(l) u3b(l) u3b2(l) u3b5(l)/ machid(l) 

performed for multi-user rc2(lM) 

performed to stop the operating rcO(lM) 

permissions file uucheck(lM) uucheck(lM) 

permit or deny messages mesg(l) 

per-process accounting records acctcms(lM) 

perusal filter for crt viewing more(l) 

perusal filter for CRTs pgd) 

pgd) file perusal filter for pgd) 

pieces split(l) 

ping(8) send ICMP ECHO_REQUEST ping(8) 

pipe fitting teed) 

pled(lM) control the front panel pled(lM) 

portable archives ar(l) archive ar(l) 

portions of path names basename(l) 

post office prmail(l) 

posters bannerd) 

postload an a.out file to run on adapt(l) 

PostScript label generator mklist(l) 

pr(l) print files pr(l) 

prctmp(lM) prdaily(lM)/ chargefee(lM) 

prdaily(lM) prtacct(lM)/ chargefee(lM) 

preprocessor C PP(D 

prevent LP requests accept(lM) 

previewing colcrt(l) colcrt(l) 

previous get of an SCCS file unget(l) 

prime factors of a number factor(l) 
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cat(lB) catenate and 

prs(l) 

date(l) 

cal(l) 

a file sum(l) 

activity sact(l) 

whoami(l) 

cat(l) concatenate and 

pr(l) 

fpr(l) asa(l) 

system hostid(l) set or 

lpstat(l) 

file nm(l) 

hostname(l) set or 

uname(l) 

news(l) 

prmail(l) 

infocmp(lM) compare or 

printenv(l) 

manual information by keywords; 

acctcom(l) search and 

common object files size(l) 

pagesize(l) 

names id(lM) 

or other/ strings(l) find the 

environment 

requests to an LP line 

disable(l) enable /disable LP 

nice(l) run a command at low 

post office 

boot(8) system boot 

bcheckrc(l) system initialization 

/startup(lM) turnacct(lM) shell 

to system maintenance 

acctprcl(lM) acctprc2(lM) 

acctcom(l) search and print 

init(lM) telinit(lM) 

timex(l) time a command; report 

kill(l) terminate a 

ps(l) report 

wait(l) await completion of 

killall(lM) kill all active 

structure fuser(lM) identify 

awk(l) pattern scanning and 

oawk(l) pattern scanning and 

mailx(l) interactive message 

halt® stop the 

m4(l) macro 

/u3b(l) u3b2(l) u3b5(l) vax(l) get 

data 

prof(l) mkprof(l) display 

the standard /restricted command 

application programs, and 

/to commands, application 

lex(l) generate 

update, and regenerate groups of 



print cat(lB) 

print an SCCS file prs(l) 

print and set the date date(l) 

print calendar cal(l) 

print checksum and block count of sum(l) 

print current SCCS file editing sact(l) 

print effective current user id whoami(l) 

print files cat(l) 

print files pr(l) 

print Fortran file fpr(l) 

print identifier of current host hostid(l) 

print LP status information lpstat(l) 

print name list of common object .. nm(l) 

print name of current host system hostname(l) 

print name of current UNIX system uname(l) 

print news items news(l) 

print out mail in the post office prmail(l) 

print out terminfo descriptions infocmp(lM) 

print out the environment printenv(l) 

print out the manual man(l) find man(l) 

print process accounting file(s) acctcom(l) 

print section sizes mbytes of .. size(l) 

print system page size pagesize(l) 

print user and group IDs and id(lM) 

printable strings in an object, strings(l) 

printenv(l) print out the printenv(l) 

printer /cancel(l) send/cancel lp(l) 

printers enable(l) .. enable(l) 

priority nice(l) 

prmail(l) print out mail in the prmail(l) 

procedure boot(8) 

procedures bcheckrc(l) 

procedures for accou chargefee(lM) 

procedures intro(8) introduction intro(8) 

process accounting acctprcl(lM) 

process accounting file(s) acctcom(l) 

process control initialization init(lM) 

process data and system activity timex(l) 

process kill(l) 

process status . ps(l) 

process wait(l) 

processes killall(lM) 

processes using a file or file , fuser(lM) 

processing language awk(l) 

processing language oawk(l) 

processing system mailx(l) 

processor halt(8) 

processor m4(l) 

processor type truth value machid(l) 

prof(l) mkprof(l) display profile prof(l) 

profile data prof(l) 

programming language /shell, sh(l) 

programming utilities /commands, intro(l) 

programs, and programming/ intro(l) 

programs for simple lexical tasks lex(l) 

programs make(l) maintain, make(l) 
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xstr(l) extract strings from C 

vgrind(l) grind nice listings of 

DARPA Internet File Transfer 

telnetd(8C) DARPA TELNET 

DARPA Trivial File Transfer 

labelit(lM) 

true(l) false(l) 

/prctmp(lM) prdaily(lM) 

file checkers 

nslookup(l) 

tput(l) initialize a terminal or 

memory/ ipcrm(l) remove a message 

a command immune to hangups and 

dialect 

ratfor(l) 

stop the operating system 

for multi-user environment 

rmail(l) send mail to users or 

line(l) 

reboot® 

from per-process accounting 

manipulate connect accounting 

ed(l) 

help(l) ask for help 

compile 

make(l) maintain, update, and 

regcmp(l) 

a file for a pattern using full 

files comm(l) select or 

requests accept(lM) 

join(l) 

leave(l) 

calendar (1) 

uuxqt(lM) execute 

rlogind(8C) 

and unmount file systems and 

rshd(8C) 

Uutry(lM) try to contact 

rmdel(l) 

set or shared memory id ipcrm(l) 

rm(l) rmdir(l) 

unifdef(l) 

constructs deroff(l) 

fsck(lM) check and 

uniq(l) report 

yes(l) be 

fsstat(lM) 

communication facilities/ ipcs(l) 

and i-nodes df(lM) 

sa2(lM) sadc(lM) system activity 

timex(l) time a command; 

ps(l) 



programs to implement shared/ xstr(l) 

programs vgrind(l) 

Protocol server ftpd(8C) ftpd(8C) 

protocol server telnetd(8C) 

Protocol server tftpd(8C) tftpd(8C) 

provide labels for file systems labelit(lM) 

provide truth values true(l) 

prs(l) print an SCCS file prs(l) 

prtacct(lM) runacct(lM)/ chargefee(lM) 

ps(l) report process status ps(l) 

pwck(lM) grpck(lM) password /group pwck(lM) 

pwd(l) working directory name pwd(l) 

query name servers interactively nslookup(l) 

query terminfo database tput(l) 

queue, semaphore set or shared ipcrm(l) 

quits nohup(l) run nohup(l) 

ratfor(l) rational Fortran ratfor(l) 

rational Fortran dialect ratfor(l) 

rcO(lM) run commands performed to rcO(lM) 

rc2(lM) run commands performed rc2(lM) 

read mail mail(l) mail(l) 

read one line line(l) 

reboot /unix reboot(8) 

reboot(8) reboot /unix reboot(8) 

records /command summary acctcms(lM) 

records fwtmp(lM) wtmpfix(lM) fwtmp(lM) 

red(l) text editor ed(l) 

regarding SCCS help(l) 

regcmp(l) regular expression regcmp(l) 

regenerate groups of programs make(l) 

regular expression compile regcmp(l) 

regular expressions /search egrep(l) 

reject lines common to two sorted comm(l) 

reject(lM) allow or prevent LP accept(lM) 

relational database operator join(l) 

remind you when you have to leave leave(l) 

reminder service calendar(l) 

remote command requests uuxqt(lM) 

remote login server rlogind(8C) 

remote resources /mount mount(lM) 

remote shell server rshd(8C) 

remote system with debugging on Uutry(lM) 

remove a delta from an SCCS file rmdel(l) 

remove a message queue, semaphore ipcrm(l) 

remove files or directories rm(l) 

remove ifdefed lines unifdef(l) 

remove nroff/troff, tbl, and eqn deroff(l) 

repair file systems fsck(lM) 

repeated lines in a file uniq(l) 

repetitively affirmative yes(l) 

report file system status fsstat(lM) 

report inter-process ipcs(l) 

report number of free disk blocks df(lM) 

report package sal(lM) sal(lM) 

report process data and system/ timex(l) 

report process status ps(l) 
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uniq(l) 

sar(l) system activity 

reject(lM) allow or prevent LP 

the LP scheduler and move 

uuxqt(lM) execute remote command 

lp(l) cancel(l) send /cancel 

arp(8C) address 

unmount file systems and remote 

indication vacation(l) 

col(l) filter 

rev(l) 

show last commands executed in 

directories 

read mail mail(l) 

SCCS file 

directories rm(l) 

chroot(lM) change 

routing tables 

gated (8) gateway 

routed(8C) network 

route(8C) manually manipulate the 

rsl70(l) turn on/off 

mode 

standard /restricted/ sh(l) 

nice(l) 

and quits nohup(l) 

multi-user environment rc2(lM) 

the operating system rcO(lM) 

runacct(lM) 

postload an a.out file to 

/prdaily(lM) prtacct(lM) 

activity report package 

report package sal(lM) 

editing activity 

package sal(lM) sa2(lM) 

bfs(l) big file 

awk(l) pattern 

oawk(l) pattern 

change the delta commentary of an 

comb(l) combine 

make a delta (change) to an 

sact(l) print current 

get(l) get a version of an 

prs(l) print an 

rmdel(l) remove a delta from an 

compare two versions of an 

undo a previous get of an 

val(l) validate 

admin(l) create and administer 



report repeated lines in a file uniq(l) 

reporter sar(l) 

requests accept(lM) accept(lM) 

requests /lpmove(lM) start/stop lpsched(lM) 

requests uuxqt(lM) 

requests to an LP line printer lp(l) 

resolution display and control arp(8C) 

resources /umount(lM) mount and mount(lM) 

return I am on vacation vacation(l) 

rev(l) reverse lines of a file rev(l) 

reverse line-feeds col(l) 

reverse lines of a file rev(l) 

reverse order lastcomm(l) lastcomm(l) 

rlogind(8C) remote login server rlogind(8C) 

rm(l) rmdir(l) remove files or rm(l) 

rmail(l) send mail to users or mail(l) 

rmdel(l) remove a delta from an rmdel(l) 

rmdir(l) remove files or rm(l) 

root directory for a command chroot(lM) 

route(8C) manually manipulate the route(8C) 

routed(8C) network routing daemon routed(8C) 

routing daemon gated(8) 

routing daemon routed(8C) 

routing tables route(8C) 

rsl70 video mode rsl70(l) 

rsl70(l) turn on/off rsl70 video rsl70(l) 

rsh(l) shell, the sh(l) 

rshd(8C) remote shell server rshd(8C) 

run a command at low priority nice(l) 

run a command immune to hangups nohup(l) 

run commands performed for rc2(lM) 

run commands performed to stop rcO(lM) 

run daily accounting runacct(lM) 

run on a Stardent 3000 adapt(l) adapt (1) 

runacct(lM) run daily accounting runacct(lM) 

runacct(lM) shutacct(lM)/ chargefee(lM) 

rwhod(8C) system status server rwhod(8C) 

sal(lM) sa2(lM) sadc(lM) system sal(lM) 

sa2(lM) sadc(lM) system activity sal(lM) 

sact(l) print current SCCS file sact(l) 

sadc(lM) system activity report sal(lM) 

sar(l) system activity reporter sar(l) 

scanner bfs(l) 

scanning and processing language awk(l) 

scanning and processing language oawk(l) 

SCCS delta cdc(l) cdc(l) 

SCCS deltas comb(l) 

SCCS file delta(l) delta(l) 

SCCS file editing activity sact(l) 

SCCS file get(l) 

SCCS file prs(l) 

SCCS file rmdel(l) 

SCCS file sccsdiff(l) sccsdiff(l) 

SCCS file unget(l) unget(l) 

SCCS file val(l) 

SCCS files admin(l) 
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what(l) identify 

help(l) ask for help regarding 

sccs(l) front end for the 

subsystem 

of an SCCS file 

/lpmove(lM) start/stop the LP 

transport/ uusched(lM) the 

clear (1) clear terminal 

screendump(l) dump the 

display 

editor based on ex vi(l) 

terminal session 

program 

string fgrep(l) 

grep(l) 

full regular/ egrep(l) 

accounting file(s) acctcom(l) 

object files sized ) print 

two sorted files comm(l) 

file cut(l) cut out 

ipcrm(l) remove a message queue, 

network hosts ping(8) 

sendmail(8) 

rnaii(l) rmail(l) 

line printer lp(l) cancel(l) 

internet 

comsat(8C) biff 

named(8) Internet domain name 

Internet File Transfer Protocol 

rlogind(8C) remote login 

rshd(8C) remote shell 

rwhod(8C) system status 

telnetd(8C) DARPA TELNET protocol 

Trivial File Transfer Protocol 

nslookup(l) query name 

calendar (1) reminder 

make typescript of terminal 

execution env(l) 

umask(l) 

apply (1) apply a command to a 

current host system hostid(l) 

system hostname(l) 

remove a message queue, semaphore 

tabs(l) 

stty(lB) 

and line discipline getty(lM) 

and line discipline uugetty(lM) 

date(l) print and 

stty(l) 

nvram(lM) display or 

of/ pasted) merge same lines of 

standard /restricted command/ 

a message queue, semaphore set or 

from C programs to implement 



SCCS files what(l) 

SCCS help(l) 

SCCS subsystem sccs(l) 

sccs(l) front end for the SCCS sccs(l) 

sccsdiff(l) compare two versions sccsdiff(l) 

scheduler and move requests lpsched(lM) 

scheduler for the uucp file uusched(lM) 

screen clear(l) 

screen display screendump(l) 

screendump(l) dump the screen screendump(l) 

screen-oriented (visual) display vi(l) 

scriptd) make typescript of script(l) 

sdiffd) side-by-side difference sdiff(l) 

search a file for a character fgrep(l) 

search a file for a pattern grepd) 

search a file for a pattern using egrep(l) 

search and print process acctcom(l) 

section sizes in bytes of common size(l) 

sed(l) stream editor sed(l) 

select or reject lines common to comm(l) 

selected fields of each line of a cut(l) 

semaphore set or shared memory id ipcrm(l) 

send ICMP ECHO_REQUEST packets to ping(8) 

send mail over the internet sendmail(8) 

send mail to users or read mail mail(l) 

send/cancel requests to an LP lp(l) 

sendmail(8) send mail over the sendmail(8) 

server comsat(8C) 

server named (8) 

server ftpd(8Q DARPA ftpd(8C) 

server rlogind(8C) 

server rshd(8C) 

server rwhod(8C) 

server telnetd(8C) 

server tftpd(8C) DARPA tftpd(8C) 

servers interactively nslookupd) 

service calendar(l) 

session scriptd) scriptd) 

set environment for command env(l) 

set file-creation mode mask umask(l) 

set of arguments apply(l) 

set or print identifier of hostid(l) 

set or print name of current host hostname(l) 

set or shared memory id ipcrm(l) ipcrmd) 

set tabs on a terminal tabs(l) 

set terminal options stty(lB) 

set terminal type, modes, speed, getty(lM) 

set terminal type, modes, speed, uugetty(lM) 

set the date dated) 

set the options for a terminal sttyd) 

set values of NVRAM variables nvram(lM) 

setmnt(lM) establish mount table setmnt(lM) 

several files or subsequent lines pasted) 

shd) rsh(l) shell, the sh(l) 

shared memory id ipcrmd) remove ipcrmd) 

shared strings /extract strings xstr(l) 
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chsh(l) change default login 

C-like syntax csh(l) a 

/startup(lM) turnacct(lM) 

rshd(8C) remote 

command programming/ sh(l) rsh(l) 

uptime(l) 

reverse order lastcomm(l) 

netstat(l) 

state shutdown(lM) 

/prtacct(lM) runacct(lM) 

change system state 

sdiff(l) 

login(l) 

lex(l) generate programs for 

pagesize(l) print system page 

bytes of common object files 

files size(l) print section 

interval 

installpkg(l) install all 

sort(l) 

tsort(l) topological 

or reject lines common to two 

look(l) find lines in a 

a/ whereis(l) locate the binary, 

unexpand(l) expand tabs to 

mknod(lM) build 

/set terminal type, modes, 

/set terminal type, modes, 

hashcheck(l) find spelling/ 

spelling/ spell(l) hashmake(l) 

spellin(l) hashcheck(l) find 

split(l) 

file into individual/ fsplit(l) 

csplit(l) context 

uucleanup(lM) uucp 

lpadmin(lM) configure the LP 

sh(l) rsh(l) shell, the 

an a.out file to run on a 

lpsched(lM) lpshut(lM) lpmove(lM) 

/runacct(lM) shutacct(lM) 

fsstat(lM) report file system 

lpstat(l) print LP 

communication facilities 

netstat(l) show network 

ps(l) report process 

rwhod(8C) system 

rcO(lM) run commands performed to 

halt(8) 

sed(l) 

search a file for a character 

implement shared/ xstr(l) extract 

strings(l) find the printable 

C programs to implement shared 

strings in an object, or other/ 



shell chsh(l) 

shell (command interpreter) with .. csh(l) 

shell procedures for accou chargefee(lM) 

shell server rshd(8C) 

shell, the standard /restricted sh(l) 

show how long system has been up uptime(l) 

show last commands executed in lastcomm(l) 

show network status , netstat(l) 

shut down system, change system shutdown(lM) 

shutacct(lM) startup(lM)/ chargefee(lM) 

shutdown(lM) shut down system, shutdown(lM) 

side-by-side difference program sdiff(l) 

sign on login(l) 

simple lexical tasks lex(l) 

size pagesize(l) 

size(l) print section sizes in size(l) 

sizes in bytes of common object size(l) 

sleep(l) suspend execution for an sleep(l) 

software distribution tapes installpkg(l) 

sort and/or merge files sort(l) 

sort tsort(l) 

sort(l) sort and/or merge files sort(l) 

sorted files comm(l) select comm(l) 

sorted list look(l) 

source, and manual page files for whereis(l) 

spaces, and vice versa expand(l) expand(l) 

special file mknod(lM) 

speed, and line discipline getty(lM) 

speed, and line discipline uugetty(lM) 

spell(l) hashmake(l) spellin(l) spell(l) 

spellin(l) hashcheck(l) find spell(l) 

spelling errors /hashmake(l) spell(l) 

split a file into pieces split(l) 

split a multi-routine Fortran fsplit(l) 

split csplit(l) 

split(l) split a file into pieces split(l) 

spool directory clean-up uucleanup(lM) 

spooling system lpadmin(lM) 

standard /restricted command/ sh(l) 

Stardent 3000 adapt(l) postload adapt(l) 

start/stop the LP scheduler and/ lpsched(lM) 

startup(lM) turnacct(lM) shell/ chargefee(lM) 

status fsstat(lM) 

status information lpstat(l) 

status /report inter-process ipcs(l) 

status netstat(l) 

status ps(l) 

status server rwhod(8C) 

stop the operating system rcO(lM) 

stop the processor halt(8) 

stream editor sed(l) 

string fgrep(l) fgrep(l) 

strings from C programs to xstr(l) 

strings in an object, or other/ strings(l) 

strings /extract strings from ....xstr(l) 

strings(l) find the printable strings(l) 



C 
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information from a/ strip(l) strip symbol and line number strip(l) 

number information from a common/ strip(l) strip symbol and line strip(l) 

mkfarm(lM) configure a striped file system mkfarm(lM) 

processes using a file or file structure fuser(lM) identify fuser(lM) 

terminal stty(l) set the options for a stty(l) 

stty(lB) set terminal options stty(lB) 

another user su(lM) become super-user or su(lM) 

/same lines of several files or subsequent lines of one file paste(l) 

sccs(l) front end for the SCCS subsystem sccs(l) 

count of a file sum(l) print checksum and block sum(l) 

du(lM) summarize disk usage du(lM) 

accounting/ acctcms(lM) command summary from per-process acctcms(lM) 

sync(lM) update the super block sync(lM) 

inetd(8) internet super-server ,. inetd(8) 

su(lM) become super-user or another user su(lM) 

sleep(l) suspend execution for an interval sleep(l) 

swap(lM) swap administrative interface swap(lM) 

interface swap(lM) swap administrative swap(lM) 

information from/ strip(l) strip symbol and line number strip(l) 

sync(lM) update the super block sync(lM) 

(command interpreter) with C-like syntax csh(l) a shell csh(l) 

syslogd(8) log systems messages syslogd(8) 

accton(8) system accounting accton(8) 

sal(lM) sa2(lM) sadc(lM) system activity report package sal(lM) 

sar(l) system activity reporter sar(l) 

command; report process data and system activity timex(l) time a timex(l) 

boot(8) system boot procedure boot(8) 

shutdown(lM) shut down system, change system state shutdown(lM) 

fsdb(lM) file system debugger fsdb(lM) 

uptime(l) show how long system has been up uptime(l) 

print identifier of current host system hostid(l) set or hostid(l) 

set or print name of current host system hostname(l) hostname(l) 

fstyp(lM) determine file system identifier fstyp(lM) 

crash(lM) examine system images crash(lM) 

bcheckrc(l) system initialization procedures bcheckrc(l) 

logger(l) make entries in the system log logger(l) 

configure the LP spooling system lpadmin(lM) lpadmin(lM) 

interactive message processing system mailx(l) mailx(l) 

intro(8) introduction to system maintenance procedures intro(8) 

configure a striped file system mkfarm(lM) mkfarm(lM) 

mkfs(lM) construct a file system mkfs(lM) 

pagesize(l) print system page size pagesize(l) 

performed to stop the operating system rcO(lM) run commands rcO(lM) 

shut down system, change system state shutdown(lM) shutdown(lM) 

fsstat(lM) report file system status fsstat(lM) 

rwhod(BC) system status server rwhod(8C) 

print name of current UNIX system uname(l) uname(l) 

list of users who are on the system users(l) compact users(l) 

who(l) who is on the system who(l) 

transport program for the uucp system uucico(lM) file uucico(lM) 

Uutry(lM) try to contact remote system with debugging on Uutry(lM) 

/umount(lM) mount and unmount file systems and remote resources mount(lM) 

fsck(lM) check and repair file systems fsck(lM) 

provide labels for file systems labelit(lM) labelit(lM) 

syslogd(8) log systems messages syslogd(8) 

mount, unmount multiple file systems /umountall(lM) mountall(lM) 
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setmnt(lM) establish mount 

manually manipulate the routing 

tabs(l) set 

expand(l) unexpand(l) expand 

ctags(l) create a 

a file 

tar(l) 

mt(l) magnetic 

tcopy(l) copy a mag 

install all software distribution 

programs for simple lexical 
deroff(l) remove nroff /troff, 



indicate last logins of users and 

initialization init(lM) 

telnetd(8C) DARPA 

server 

terminfo/ captoinfo(lM) convert a 

tset,reset(l) 

stty(lB) set 

database tput(l) initialize a 

clear(l) clear 

script(l) make typescript of 

stty(l) set the options for a 

tabs(l) set tabs on a 

tty(l) get the name of the 

line discipline getty(lM) set 

line discipline uugetty(lM) set 

kill(l) 

tic(lM) 

initialize a terminal or query 

a termcap description into a 

infocmp(lM) compare or print out 

command 

ed(l) red(l) 

ex(l) 

casual users) edit(l) 

newform(l) change the format of a 

Transfer Protocol server 



update access and modification 

process data and system activity 

pdpll(l) u3b(l)/ machid(l) 

tsort(l) 

acctmerg(lM) merge or add 

modification times of a file 

query terminfo database 

ftpd(8C) DARPA Internet File 

tftpd(8C) DARPA Trivial File 

tr(l) 

system uucico(lM) file 



table setmnt(lM) 

tables route(8C) route(8C) 

tabs on a terminal tabs(l) 

tabs to spaces, and vice versa expand(l) 

tabs(l) set tabs on a terminal tabs(l) 

tags file ctags(l) 

tail(l) deliver the last part of tail(l) 

tape file archiver tar(l) 

tape manipulating program mt(l) 

tape . tcopy(l) 

tapes installpkg(l) installpkg(l) 

tar(l) tape file archiver tar(l) 

tasks lex(l) generate lex(l) 

tbl, and eqn constructs deroff(l) 

tcopy(l) copy a mag tape tcopy(l) 

tee(l) pipe fitting tee(l) 

teletypes last(l) last(l) 

telinit(lM) process control init(lM) 

TELNET protocol server telnetd(8C) 

telnetd(8C) DARPA TELNET protocol .telnetd(8C) 

termcap description into a captoinfo(lM) 

terminal dependent initialization tset,reset(l) 

terminal options stty(lB) 

terminal or query terminfo tput(l) 

terminal screen clear(l) 

terminal session script(l) 

terminal stty(l) 

terminal tabs(l) 

terminal tty(l) 

terminal type, modes, speed, and getty(lM) 

terminal type, modes, speed, and uugetty(lM) 

terminate a process kill(l) 

terminfo compiler tic(lM) 

terminfo database tput(l) tput(l) 

terminfo description /convert captoinfo(lM) 

terminfo descriptions infocmp(lM) 

test(l) condition evaluation test(l) 

text editor ed(l) 

text editor ex(l) 

text editor (variant of ex for edit(l) 

text file newform(l) 

tftpd(8C) DARPA Trivial File tftpd(8C) 

tic(lM) terminfo compiler tic(lM) 

time(l) time a command time(l) 

times of a file touch(l) touch(l) 

timex(l) time a command; report timex(l) 

titan(l) mips(l) m68000(l) machid(l) 

topological sort tsort(l) 

total accounting files acctmerg(lM) 

touch(l) update access and touch(l) 

tput(l) initialize a terminal or tput(l) 

tr(l) translate characters tr(l) 

Transfer Protocol server ftpd(8C) 

Transfer Protocol server tftpd(8C) 

translate characters tr(l) 

transport program for the uucp uucico(lM) 
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the scheduler for the uucp file 

server tftpd(8C) DARPA 

values 

u3b5(l) vax(l) get processor type 

trued ) false(l) provide 

debugging on Uutry(lM) 

initialization 

terminal 

pal(l) 

rsl70(l) 

accou /shutacct(lM) startup(lM) 

file(l) determine file 

getty(lM) set terminal 

uugetty(lM) set terminal 

u3b5(l) vax(l) get processor 

script(l) make 

/mips(l) m68000(l) pdpll(l) 

/mips(l) m68000(l) pdpll(l) u3b(l) 

/m68000(l) pdpll(l) u3b(l) u3b2(l) 



mask 

systems and remote/ mount(lM) 

multiple file/ mountall(lM) 

UNIX system 

and expand data compress(l) 

ul(l)do 

file unget(l) 

spaces, and vice versa expand(l) 

an SCCS file 

a file 

reboot(8) reboot 

uname(l) print name of current 

link(lM) unlink(lM) link and 

and directories link(lM) 

mount (1M) umount(lM) mount and 

mountall(lM) umountall(lM) mount, 

files pack(l) pcat(l) 

times of a file touch(l) 

programs make(l) maintain, 

sync(lM) 

has been up 

du(lM) summarize disk 

id(lM) print 

crontab(l) 

whoami(l) print effective current 

generate disk accounting data by 

finger (1) 

write(l) write to another 

become super-user or another 

last(l) indicate last logins of 

editor (variant of ex for casual 

mail(l) rmail(l) send mail to 



transport program uusched(lM) uusched(lM) 

Trivial File Transfer Protocol tftpd(8C) 

true(l) false(l) provide truth true(l) 

truth value /u3b(l) u3b2(l) machid(l) 

truth values true(l) 

try to contact remote system with Uutry(lM) 

tset,reset(l) terminal dependent tset,reset(l) 

tsort(l) topological sort tsort(l) 

tty(l) get the name of the tty(l) 

turn on/off PAL video mode pal(l) 

turn oil/off rsl 70 video mode rsl70(l) 

turnacct(lM) shell procedures for chargefee(lM) 

type file(l) 

type, modes, speed, and line/ getty(lM) 

type, modes, speed, and line/ uugetty(lM) 

type truth value /u3b(l) u3b2(l) machid(l) 

typescript of terminal session script(l) 

u3b(l)u3b2(l) u3b5(l) vax(l) get/ machid(l) 

u3b2(l) u3b5(l) vax(l) get/ .. machid(l) 

u3b5(l) vax(l) get processor type/ machid(l) 

uadmin(lM) administrative control uadmin(lM) 

ul(l) do underlining ul(l) 

umask(l) set file-creation mode umask(l) 

umount(lM) mount and unmount file mount(lM) 

umountall(lM) mount, unmount mountall(lM) 

uname(l) print name of current uname(l) 

uncompress(l) zcat(l) compress compress(l) 

underlining . ul(l) 

undo a previous get of an SCCS unget(l) 

unexpand(l) expand tabs to expand(l) 

unget(l) undo a previous get of unget(l) 

unifdef(l) remove ifdefed lines unifdef(l) 

uniq(l) report repeated lines in uniq(l) 

units(l) conversion program units(l) 

/unix reboot(8) 

UNIX system -.. uname(l) 

unlink files and directories link(lM) 

unlink(lM) link and unlink files link(lM) 

unmount file systems and remote/ mount (1M) 

unmount multiple file systems mountall(lM) 

unpack(l) compress and expand pack(l) 

update access and modification touch(l) 

update, and regenerate groups of make(l) 

update the super block sync(lM) 

uptime(l) show how long system uptime(l) 

usage du(lM) 

user and group IDs and names id(lM) 

user crontab file crontab(l) 

user id whoami(l) 

user ID diskusg(lM) diskusg(lM) 

user information lookup program finger(l) 

user write(l) 

user su(lM) su(lM) 

users and teletypes last(l) 

users) edit(l) text edit(l) 

users or read mail mail(l) 
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wall(l) write to all 

users(l) compact list of 

who are on the system 

fuser(lM) identify processes 

of the memory for later analysis 

/search a file for a pattern 

programs, and programming 

directories and permissions file 

for the uucp system 

directory clean-up 

file uucheck(lM) check the 

uusched(lM) the scheduler for the 

uucleanup(lM) 

file transport program for the 

modes, speed, and line/ 

uucp file transport program 

system with debugging on 

requests 

vacation(l) return I am on 

vacation indication 

val(l) 

vax(l) get processor type truth 

true(l) false(l) provide truth 

nvram(lM) display or set 

display or set values of NVRAM 

edit(l) text editor 

/pdpll(l) u3b(l) u3b2(l) u3b5(l) 

information 

expand tabs to spaces, and vice 

vc(l) 

vers(l) obtain 

get(l) get a 

/index manpages allowing man 

programs 

display editor based on ex 

expand tabs to spaces, and 

pal(l) turn on/off PAL 

rsl70(l) turn on/off rsl70 

file perusal filter for crt 

ex vi(l) screen-oriented 

dvhtool(lM) modify disk 

doing 

process 



is 

source, and manual page files/ 

including aliases and paths 

user id 

fold long lines for finite 
wc(l) 



users , wall(l) 

users who are on the system users(l) 

users(l) compact list of users users(l) 

using a file or file structure fuser(lM) 

using crash(lM) /the state dump(8) 

using full regular expressions egrep(l) 

utilities /commands, application intro(l) 

uucheck(lM) check the uucp uucheck(lM) 

uucico(lM) file transport program uucico(lM) 

uucleanup(lM) uucp spool uucleanup(lM) 

uucp directories and permissions uucheck(lM) 

uucp file transport program uusched(lM) 

uucp spool directory clean-up uucleanup(lM) 

uucp system uucico(lM) uucico(lM) 

uugetty(lM) set terminal type, uugetty(lM) 

uusched(lM) the scheduler for the uusched(lM) 

Uutry(lM) try to contact remote Uutry(lM) 

uuxqt(lM) execute remote command uuxqt(lM) 

vacation indication vacation(l) 

vacation(l) return I am on vacation(l) 

val(l) validate SCCS file val(l) 

validate SCCS file val(l) 

value /u3b(l) u3b2(l) u3b5(l) machid(l) 

values true(l) 

values of NVRAM variables nvram(lM) 

variables nvram(lM) nvram(lM) 

(variant of ex for casual users) edit(l) 

vax(l') get processor type truth/ machid(l) 

vc(l) version control vc(l) 

vers(l) obtain version vers(l) 

versa expand(l) unexpand(l) expand(l) 

version control vc(l) 

version information , vers(l) 

version of an SCCS file get(l) 

very_long_name to work makeindex(8) 

vgrind(l) grind nice listings of vgrind(l) 

vi(l) screen-oriented (visual) vi(l) 

vice versa expand(l) unexpand(l) expand(l) 

video mode pal(l) 

video mode rsl70(l) 

viewing more(l) page(l) more(l) 

(visual) display editor based on vi(l) 

volume header information dvhtool(lM) 

w(l) who is on and what they are w(l) 

wait(l) await completion of wait(l) 

wall(l) write to all users wall(l) 

wc(l) word count wc(l) 

what(l) identify SCCS files what(l) 

whatis(l) describe what a command whatis(l) 

whereis(l) locate the binary, whereis(l) 

which(l) locate a program file which(l) 

who(l) who is on the system who(l) 

whoami(l) print effective current whoami(l) 

whodo(lM) who is doing what whodo(lM) 

width output device fold(l) fold(l) 

word count wc(l) 
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cd(l) change working directory cd(l) 

pwd(l) working directory name pwd(l) 

wall(l) write to all users wall(l) 

write(l) write to another user write(l) 

write(l) write to another user write(l) 

accounting records fwtmp(lM) wtmpfix(lM) manipulate connect fwtmp(lM) 

list(s) and execute command xargs(l) construct argument xargs(l) 

programs to implement shared/ xstr(l) extract strings from C xstr(l) 

compiler-compiler yacc(l) yet another yacc(l) 

affirmative yes(l) be repetitively yes(l) 

yacc(l) yet another compiler-compiler yacc(l) 

compress(l) uncompress(l) zcat(l) compress and expand data compress(l) 

zdump(8) time zone dumper zdump(8) 

zic(8) time zone compiler zic(8) 

zic(8) time zone compiler zic(8) 

zdump(8) time zone dumper zdump(8) 
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INTRO (1) 



NAME 

intro - introduction to commands, application programs, and programming utilities 

DESCRIPTION 

This section describes, in alphabetical order, commands available for the Stardent 
1500/3000 single user supercomputer. Certain distinctions of purpose are made in 
the headings. 

The following Utility packages are delivered with the Stardent 1500/3000: 

Advanced C Utilities 

Basic Networking Utilities 

C Programming Language Utilities 

Directoiy and File Management Utilities 

Editing Utilities 

Essential Utilities 

Extended Software Generation System Utilities 

Graphics Utilities 

Help Utilities 

Inter-process Communications 

Line Printer Spooling Utilities 

Networking Support Utilities 

Performance Measurement Utilities 

Remote File Sharing Utilities 

Security Administration Utilities 

Software Generation System Utilitites 

Source Code Control System Utilities 

Spell Utilities 

Terminal Filters Utilities 

Terminal Information Utilities 

User Environment Utilities 

Windowing Utilities 

The following Utility Packages are available options: 

Documenter's Workbench 
Fortran Programming Utilities 
Network File System (NFS) Utilities 

In addition to the System V Release 3 commands that form the basis of the Stardent 
1500/3000 operating system, some additional 4.3 BSD commands are available to 
duplicate the functionality of 4.3 BSD. These commands are: cat (IB), cp(lB), diff (IB), 
install(lB), and stty (IB). You can access these commands by including /usr/ucb as the 
first element in your search path. 

Manual Page Command Syntax 

Unless otherwise noted, commands described in the SYNOPSIS section of a manual 
page accept options and other arguments according to the following syntax and 
should be interpreted as explained below. 

name [-option...] [cmdarg...] 
where: 



[] 



Surround an option or cmdarg that is not required. 
Indicates multiple occurrences of the option or cmdarg . 
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name 
option 



The name of an executable file. 

(Always preceded by a "-".) 
noargletter ... or, argletter 
optarg[,...] 

noargletter 



c 



A single letter representing an option without an 
option-argument. Note that more than one noargletter 
option can be grouped after one "-" (Rule 5, below). 

argletter A single letter representing an option requiring an 
option-argument. 

optarg An option-argument (character string) satisfying a 

preceding argletter. Note that groups of optargs follow- 
ing an argletter must be separated by commas, or 
separated by white space and quoted (Rule 8, below). 

cmdarg Path name (or other command argument) not beginning with "-", or 

"_" by itself indicating the standard input. Throughout the manual 
pages there are references to TMPDIR, BINDIR, INCDIR, LIBDIR, and 
LLIBDIR. These represent directory names whose value is specified 
on each manual page as necessary. For example, TMPDIR might refer 
to /imp or /usr/tmp. These are not environment variables and cannot 
be set. [There is also an environment variable called TMPDIR which 
can be set. See tmpnam(3S).] 

Command Syntax Standard: Rules 

These command syntax rules are not followed by all current commands, but all new 
commands will obey them, getopts (1) should be used by all shell procedures to parse 
positional parameters and to check for legal options. It supports Rules 3-10 below. 
The enforcement of the other rules must be done by the command itself. 



1. 

2. 

3. 
4. 
5. 
6. 

7. 



9. 
10. 
11. 
12. 



Command names {name above) must be between two and nine characters 
long. 

Command names must include only lower-case letters and digits. 

Option names {option above) must be one character long. 

All options must be preceded by "-". 

Options with no arguments may be grouped after a single "-". 

The first option-argument {optarg above) following an option must be pre- 
ceded by white space. 

Option-arguments cannot be optional. 

Groups of option-arguments following an option must either be 
separated by commas or separated by white space and quoted (e.g., -o 
xxx f z,yyor -o "xxx z yy"). 

All options must precede operands {cmdarg above) on the command line. 

"- — " may be used to indicate the end of the options. 

The order of the options relative to one another should not matter. 

The relative order of the operands {cmdarg above) may affect their 
significance in ways determined by the command with which they 
appear. 
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SEE ALSO 
DIAGNOSTICS 



WARNINGS 



13. "-" preceded and followed by white space should only be used to mean 
standard input. 

getopts(l), exit(2), wait(2), getopt(3C) 

Upon termination, each command returns two bytes of status, one supplied by the 
system and giving the cause for termination, and (in the case of "normal" termina- 
tion) one supplied by the program [see wait (2) and exit (2)]. The former byte is for 
normal termination; the latter is customarily for successful execution and non-zero 
to indicate troubles such as erroneous parameters, or bad or inaccessible data. It is 
called variously "exit code", "exit status", or "return code", and is described only 
where special conventions are involved. 

Some commands produce unexpected results when processing files containing null 
characters. These commands often treat text input lines as strings and therefore 
become confused upon encountering a null character (the string terminator) within a 
line. 
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ACCEPT(1M) ACCEPT(1M) 

NAME 



accept, reject - allow or prevent LP requests 



( 



SYNOPSIS 



/usr/lib/accept destinations 
/usr/lib/reject [ -r[ reason ] ] destinations 

DESCRIPTION 

accept allows lp(l) to accept requests for the named destinations. A destination can be 
either a line printer (LP) or a class of printers. Use Ipstatd) to find the status of desti- 
nations. 

Reject prevents lp(l) from accepting requests for the named destinations. A destination 
can be either a printer or a class of printers. Use Ipstatd) to find the status of destina- 
tions . The following option is useful with reject. 

~r[ reason ] Associates a reason with preventing Ip from accepting requests. This rea- 
son applies to all printers mentioned up to the next -r option. Reason is 
reported by Ip when users direct requests to the named destinations and 
by Ipstatd). If the -r option is not present or the -r option is given 
without a reason, then a default reason will be used. 



FILES 
SEE ALSO 



/usr/spool/lp/* 

lpadmin(lM), lpsched(lM). 
enabled), lp(l), Ipstatd) 



( 



( 
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ACCT(1M) 
NAME 

SYNOPSIS 



DESCRIPTION 



FILES 



ACCT(1M) 



overview of accounting and miscellaneous 



acctdisk, acctdusg, accton, acctwtmp - 
accounting commands 

/usr/lib/acct/acctdisk 
/usr/lib/acct/acctdusg [ -u file] [-p file] 
/usr/lib/acct/accton [file] 
/usr/lib/acct/acctwtmp "reason" 



Accounting software is structured as a set of tools (consisting of both C programs 
and shell procedures) that can be used to build accounting systems, acctsh (1M) 
describes the set of shell procedures built on top of the C programs. 

Connect time accounting is handled by various programs that write records into 
/etc/utmp, as described in utmp(4). The programs described in acrtcon(lM) convert 
this file into session and charging records, which are then summarized by 
acctmerg(lM). 

Process accounting is performed by the UNIX system kernel. Upon termination of a 
process, one record per process is written to a file (normally /usr/adm/pacct). The pro- 
grams in acctprc (1M) summarize this data for charging purposes; acctcrns (1M) is used 
to summarize command usage. Current process data may be examined using 
acctcom(l). 

Process accounting and connect time accounting (or any accounting records in the 
format described in acct(A)) can be merged and summarized into total accounting 
records by acctmerg (see tacct format in acct(4)). prtacct (see acctsh{\M)) is used to 
format any or all accounting records. 

acctdisk reads lines that contain user ID, login name, and number of disk blocks and 
converts them to total accounting records that can be merged with other accounting 
records. 

acctdusg reads its standard input (usually from find / -print) and computes disk 
resource consumption (including indirect blocks) by login. If -u is given, records 
consisting of those filenames for which acctdusg charges no one are placed in file (a 
potential source for finding users trying to avoid disk charges). If -p is given, file is 
the name of the password file. This option is not needed if the password file is 
/etc/passwd. (See diskusgilM) for more details.) 

accton alone turns process accounting off. If file is given, it must be the name of an 
existing file, to which the kernel appends process accounting records (see acct(2) and 
acct(4)). 

acctwtmp writes a utmpii) record to its standard output. The record contains the 
current time and a string of characters that describe the reason. A record type of 
ACCOUNTING is assigned (see utmpW). reason must be a string of 11 or fewer char- 
acters, numbers, $, or spaces. For example, the following are suggestions for use in 
reboot and shutdown procedures, respectively: 

acctwtmp uname » /etc/wtmp 
acctwtmp "file save" » /etc/wtmp 

/etc/passwd used for login name to user ID conversions 

/usr/lib/acct holds all accounting commands listed in 
sub-class 1M of this manual 
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/usr/adm/pacct current process account] 
/etc/wtmp login/logoff history file 



/usr/adm/pacct current process accounting file | 



SEE ALSO 

acct(2), acct(4), acctcms(lM), acctcom(l) acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), diskusg(lM), fwtmp(lM), runacct(lM), utmp(4) 
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SYNOPSIS 

DESCRIPTION 



SEE ALSO 



BUGS 



ACCTCMS(IM) 



acctcms - command summary from per-process accounting records 

/usr/lib/acct/acctcms [options] files 

acctcms reads one or more files, normally in the form described in acct(A). It adds all 
records for processes that executed identically-named commands, sorts them, and 
writes them to the standard output, normally using an internal summary format. 
The options are: 

-a Print output in ASCII rather than in the internal summary format. The output 
includes command name, number of times executed, total kcore-minutes^ total 
CPU minutes, total real minutes, mean size (in K), mean CPU minutes per invo- 
cation, "hog factor", characters transferred, and blocks read and written, as in 
acctcomd). Output is normally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under "***other". 

-n Sort by number of command invocations. 

-s Any filenames encountered hereafter are already in internal summary format. 

-t Process all records as total accounting records. The default internal summary 
format splits each field into prime and non-prime time parts. This option com- 
bines the prime and non-prime time parts into a single field that is the total of 
both, and provides upward compatibility with old (i.e., UNIX System V) style 
acctcms internal summary format records. 

The following options may be used only with the -a option. 

-p Output a prime-time-only command summary. 

-o Output a non-prime (offshift) time only command summary. 

When -p and -o are used together, a combination prime and non-prime time report 
is produced. All the output summaries will be total usage except number of times 
executed, CPU minutes, and real minutes, which will be split into prime and non- 
prime. 

A typical sequence for performing daily command accounting and for maintaining a 
running total is: 

acctcms file . . . > today 

cp total previoustotal 

acctcms -s today previoustotal > total 

acctcms -a -s today 

acct(lM), acct(2), acct(4), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), runacct(lM), utmp(4) 

Unpredictable output results if -t is used on new style internal summary format files, 
or if it is not used with old style internal summary format files. 
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NAME 

SYNOPSIS 

DESCRIPTION 



ACCTCOM(1) 



acctcom - search and print process accounting file(s) 

acctcom [ [ options ] [ file ] ] . . . 

acctcom reads file, the standard input, or /usr/adm/pacct, in the form described by 
acct(4) and writes selected records to the standard output. Each record represents 
the execution of one process. The output shows the COMMAND NAME, USER, 
TTYNAME, START TIME, END TIME, REAL (SEC), CPU (SEC), MEAN SIZE(K), and 
optionally, F (the fork /exec flag: 1 for fork without exec), STAT (the system exit status), 
HOG FACTOR, KCORE MIN, CPU FACTOR, CHARS TRNSFD, and BLOCKS READ 
(total blocks read and written). 

A # is prepended to the command name if the command was executed with 
superuser privileges. If a process is not associated with a known terminal, a ? is 
printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a terminal or 
/dev/null (as is the case when using & in the shell), /usr/adm/pacct is read; otherwise, 
the standard input is read. 

If any file arguments are given, they are read in their respective order. Each file is 
normally read forward, i.e., in chronological order by process completion time. The 
file /usr/adm/pacct is usually the current file to be examined; a busy system may need 
several such files of which all but the current file are found in /usr/adm/pacct? The 
options are: 

-a Show some average statistics about the processes selected. The statis- 

tics will be printed after the output records. 

-b Read backwards, showing latest commands first. This option has no 

effect when the standard input is read. 

-f Print the fork /exec flag and system exit status columns in the output. 

The numeric output for this option will be in octal. 

-h Instead of mean memory size, show the fraction of total available CPU 

time consumed by the process during its execution. This "hog factor" is 
computed as: 

(total CPU time)/ (elapsed time). 

-i Print columns containing the I/O counts in the output. 

-k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor (user time/ (system-time + user-time). 

-t Show separate system and user CPU times. 

-v Exclude column headings from the output. 

-1 line Show only processes belonging to terminal /dev/line. 

-u user Show only processes belonging to user that may be specified by: a user 

ID, a login name that is then converted to a user ID, a #, which desig- 
nates only those processes executed with superuser privileges, or ?, 
which designates only those processes associated with unknown user 
IDs. 

-g group Show only processes belonging to group. The group may be designated 
by either the group ID or group name. 

-s time Select processes existing at or after time, given in the format 

hr[:min [:sec]]. 

-e time Select processes existing at or before time . 
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FILES 



SEE ALSO 



BUGS 



-S time Select processes starting at or after time . 

-E time Select processes ending at or before time . Using the same time for both 

-S and -E shows the processes that existed at time. 
-n pattern Show only commands matching pattern that may be a regular expres- 
sion as in ed(l) except that + means one or more occurrences. 
-q Do not print any output records, just print the average statistics as with 

the -a option. 
-o ofile Copy selected process records in the input data format to ofile; supress 

standard output printing. 
-H factor Show only processes that exceed factor, where factor is the "hog factor" 

as explained in option -h above. 
-O sec Show only processes with CPU system time exceeding sec seconds. 

-C sec Show only processes with total CPU time, system plus user, exceeding 

sec seconds. 
-I chars Show only processes transferring more characters than the cutoff 

number given by chars . 

/etc/passwd 

/usr/adm/pacct 

/etc/group 

acct(lM), acct(2), acct(4), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), ps(l), runacct(lM), su(l), utmp(4) 

acctcom reports only on processes that have terminated; use ps(l) for active processes. 
If time exceeds the present time, then time is interpreted as occurring on the previous 
day. 
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DESCRIPTION 



ACCTCON(IM) 



EXAMPLES 



FILES 
SEE ALSO 

BUGS 



acctconl, acctcon2 - connect-time accounting 

/usr/lib/acct/acctconl [options] 
/usr/lib/acct/acctcon2 

acctconl converts a sequence of login/logoff records read from its standard input to a 
sequence of records, one per login session. Its input should normally be redirected 
from /etc/wimp. Its output is ASCII, giving device, user ID, login name, prime connect 
time (seconds), non-prime connect time (seconds), session starting time (numeric), 
and starting date and time. The options are: 

-p Print input only, showing line name, login name, and time (in both numeric 
and date/time formats). 

-t acctconl maintains a list of lines on which users are logged in. When it 
reaches the end of its input, it emits a session record for each line that still 
appears to be active. It normally assumes that its input is a current file, so 
that it uses the current time as the ending time for each session still in pro- 
gress. The -t flag causes it to use, instead, the last time found in its input, 
thus assuring reasonable and repeatable numbers for non-current files. 

-1 file file is created to contain a summary of line usage showing line name, number 
of minutes used, percentage of total elapsed time used, number of sessions 
charged, number of logins, and number of logoffs. This file helps track line 
usage, identify bad lines, and find software and hardware oddities. Hangup, 
termination of logj.nO) and termination of the login shell each generate logoff 
records, so that the number of logoffs is often three to four times the number 
of sessions. See init (1M) and utmp(4). 

-o file file is filled with an overall record for the accounting period, giving starting 
time, ending time, number of reboots, and number of date changes. 

acctconl expects as input a sequence of login session records and converts them into 
total accounting records (see tacct format in acct(4)). 

These commands are typically used as shown below. The file ctmp is created only for 
the use of acctprc(lM) commands: 

acctconl -t -1 lineuse -o reboots <wtmp I sort +ln +2 > ctmp 
acctcon2 <ctmp I acctmerg > ctacct 

/etc/wtmp 

acct(lM), acct(2), acct(4), acctcms(lM), acctcom(l), acctmerg(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), init(lM), login(l), runacct(lM), utmp(4) 

The line usage report is confused by date changes. Use wtmpfix (see fwtmp(lM)) to 
correct this situation. 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLES 



SEE ALSO 



acctmerg - merge or add total accounting files 

/usr/lib/acct/acctmerg [options] [file] ... 

acctmerg reads its standard input and up to nine additional files, all in the tacct for- 
mat (see acct(A)) or an ASCII version thereof. It merges these inputs by adding 
records whose keys (normally user ID and name) are identical, and expects the inputs 
to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-v Produce output in verbose ASCII format, with more precise notation for 
floating-point numbers. 

The following sequence is useful for making "repairs" to any file kept in this format: 

acctmerg -v <filel > file2 
Edit file! as desired . . . 

acctmerg -i <file2 > filel 

acct(lM), acct(2), acct(4), acctcms(lM), acctcom(l), acctcon(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), runacct(lM), utmp(4) 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 

BUGS 



CAVEAT 



ACCTPRC(IM) 



acctprcl, acctprc2 - process accounting 

/usr/lib/acct/acctprcl [ctmp] 
/usr/lib/acct/acctprc2 

acctprcl reads input in the form described by acct(4), adds login names correspond- 
ing to user IDs, then writes for each process an ASCII line giving user ID, login name, 
prime CPU time (tics), non-prime CPU time (tics), and mean memory size (in memory 
segment units). If ctmp is given, it is expected to contain a list of login sessions, in the 
form described in acctconQM), sorted by user ID and login name. If this file is not 
supplied, it obtains login names from the password file. The information in ctmp 
helps it distinguish among different login names that share the same user ID. 

acctprcl reads records in the form written by acctprcl , summarizes them by user ID 
and name, then writes the sorted summaries to the standard output as total account- 
ing records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct I acctprc2 >ptacct 

/etc/passwd 

acct(lM), acct(2), acct(4), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctsh(lM), cron(lM), fwtmp(lM), runacct(lM), utmp(4) 

Although it is possible to distinguish among login names that share user IDs for com- 
mands run normally, it is difficult to do this for those commands run from cron (1M), 
for example. More precise conversion can be done by faking login sessions on the 
console via the acctwtmp program in acct(lM). 

A memory segment of the mean memory size is a unit of measure for the number of 
bytes in a logical memory segment on a particular processor. 



c 



( 



( 



12 



Stardent 1500/3000 



Process Accounting Utilities 



ACCTSH(1M) 
NAME 

SYNOPSIS 



DESCRIPTION 



ACCTSH(1M) 



chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, prdaily, prtacct, 
runacct, shutacct, startup, turnacct - shell procedures for accounting 

/usr/lib/acct/chargef ee login-name number 
/usr/lib/acct/ckpacct [blocks] 
/usr/lib/acct/dodisk [-o] [files ...] 
/usr/lib/acct/lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/prctmp 
/usr/lib/acct/prdaily [-1] [-c] [mmdd] 
/usr/lib/acct/prtacct file [ "heading" ] 
/usr/lib/acct/runacct [mmdd] [mmdd state] 
/usr/lib/acct/shutacct [ "reason" ] 
/usr/lib/acct/startup 
/usr/lib/acct/turnacct on I off I switch 

chargefee can be invoked to charge a number of units to login-name. A record is writ- 
ten to /usr/adm/fee, to be merged with other accounting records during the night. 

ckpacct should be initiated via cron(lM). It periodically checks the size of 
/usr/adm/pacct. If the size exceeds blocks, 1000 by default, turnacct will be invoked 
with argument switch. If the number of free disk blocks in the jusr file system falls 
below 500, ckpacct will automatically turn off the collection of process accounting 
records via the off argument to turnacct. When at least this number of blocks is 
restored, the accounting will be activated again. This feature is sensitive to the fre- 
quency at which ckpacct is executed, usually by cron. 

dodisk should be invoked by cron to perform the disk accounting functions. By 
default, it will do disk accounting on the special files in /etc/fstab. If the -o flag is 
used, it will do a slower version of disk accounting by login directory, files specifies 
the one or more filesystem names where disk accounting will be done. If files are 
used, disk accounting will be done on these filesystems only. If the -o flag is used, 
files should be mount points of mounted filesystems. If omitted, they should be the 
special file names of mountable filesystems. 

lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, which shows 
the last date on which each person logged in. 

monacct should be invoked once each month or each accounting period, number indi- 
cates which month or period it is. If number is not given, it defaults to the current 
month (01-12). This default is useful if monacct is to executed via cron (1M) on the 
first day of each month, monacct creates summary files in /usr/adm/acct/fiscal and 
restarts summary files in /usr/adm/acct/sum. 

nulladm creates file with mode 664 and ensures that owner and group are adm. It is 
called by various accounting shell procedures. 

prctmp can be used to print the session record file (normally /usr/adm/acct/nite/ctmp 
created by acctcon(lM). 
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ACCTSH(1M) 



FILES 



SEE ALSO 



prdaily is invoked by runacct to format a report of the previous day's accounting 
data. The report resides in /usr/adm/acct/sum/rprt mmdd where mmdd is the month 
and day of the report. The current daily accounting reports may be printed by typ- 
ing prdaily. Previous days 7 accounting reports can be printed by using the mmdd 
option and specifying the exact report date desired. The -1 flag prints a report of 
exceptional usage by login id for the specifed date. Previous daily reports are 
cleaned up and therefore inaccessible after each invocation of monacct. The -c flag 
prints a report of exceptional resource usage by command, and may be used on 
current day's accounting data only. 

prtacct can be used to format and print any total accounting (tacct) file. 

runacct performs the accumulation of connect, process, fee, and disk accounting on a 
daily basis. It also creates summaries of command usage. For more information, see 
runacct(lM). 

shutacct is invoked during a system shutdown to turn process accounting off and 
append a "reason" record to /etc/wtmp. 

startup can be called to turn the accounting on when the system is brought to a 
multi-user state. 

turnacct is an interface to accton (see acct(lM)) to turn process accounting on or off. 
The switch argument turns accounting off, moves the current /usr/adm/pacct to the 
next free name in /usr/adm/pacctincr (where incr is a number starting with 1 and 
incrementing by one for each additional pacct file), then turns accounting back on 
again. This procedure is called by ckpacct and thus can be taken care of by the cron 
and used to keep pacct to a reasonable size, acct starts and stops process accounting 
via init and shutdown accordingly. 



/usr/adm/fee 

/usr/adm/pacct 

/usr/adm/pacct* 



accumulator for fees 
current file for per-process accounting 
used if pacct gets large and during 
execution of daily accounting procedure 
/etc/wtmp login/logoff summary 

/usr/lib/acct/ptelus.awk contains the limits for exceptional 

usage by login id 
/usr/lib/acct/ptecms.awkcontains the limits for exceptional 

usage by command name 
working directory 

holds all accounting commands listed in 
sub-class 1M of this manual 
summary directory, should be saved 



/usr/adm/acct/nite 
/usr/lib/acct 

/usr/adm/acct/sum 



acct(lM), acct(2), acct(4), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctprc(lM), cron(lM), diskusg(lM), fwtmp(lM), runacct(lM), utmp(4) 
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NAME 

adapt - postload an a.out file to run on a Stardent 3000 

SYNOPSIS 

adapt [ -v ] [ infile [ outfile ] ] 

DESCRIPTION 

adapt takes as input an executable file for a Stardent 1500 system and produces an 
executable file for the Stardent 3000. The resultant output file is functionally identi- 
cal to the input file, infile is the name of the input object file compiled for Stardent 
1500 execution, outfile is optional. If no name is specified for the output file, a file 
named x.out is produced. 

OPTIONS 

-v causes adapt to provide diagnostic information about the postloading process. 
With this option, whenever an instruction gets changed by the postloader, the 
address in the input file where the change occured and the new instruction 
inserted are listed on stderr. 
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ADMIN (1) 



admin - create and administer SCCS files 

admin [-n] [-i[name]] [-rrel] [-t[name]] [-fflag[flag-val]] [-dflag[flag-val]] [-alogin] 
[-elogin] [-m[mrlist]] [--y [comment]] [-h] [-z] files 

admin is used to create new SCCS files and change parameters of existing ones. Argu- 
ments to admin, which may appear in any order, consist of keyletter arguments, 
which begin with -, and named files (note that SCCS file names must begin with the 
characters s.). If a named file does not exist, it is created, and its parameters are ini- 
tialized according to the specified keyletter arguments. Parameters not initialized by 
a keyletter argument are assigned a default value. If a named file does exist, parame- 
ters corresponding to specified keyletter arguments are changed, and other parame- 
ters are left as is. 

If a directory is named, admin behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a name of - is 
given, the standard input is read; each line of the standard input is taken to be the 
name of an SCCS file to be processed. Again, non-SCCS files and unreadable files are 
silently ignored. 

The keyletter arguments are as follows. Each is explained as though only one named 
file is to be processed since the effects of the arguments apply independently to each 
named file. 

-n This keyletter indicates that a new SCCS file is to be created. 

-{[name] The name of a file from which the text for a new SCCS file is to 

be taken. The text constitutes the first delta of the file (see -r 
keyletter for delta numbering scheme). If the i keyletter is 
used, but the file name is omitted, the text is obtained by read- 
ing the standard input until an end-of-file is encountered. If 
this keyletter is omitted, then the SCCS file is created empty. 
Only one SCCS file may be created by an admin command on 
which the i keyletter is supplied. Using a single admin to 
create two or more SCCS files requires that they be created 
empty (no -i keyletter). Note that the -i keyletter implies the 
-n keyletter. 

-xrel The refease into which the initial delta is inserted. This 

keyletter may be used only if the -i keyletter is also used. If 
the -r keyletter is not used, the initial delta is inserted into 
release 1. The level of the initial delta is always 1 (by default 
initial deltas are named 1.1). 

-t[name] The name of a file from which descriptive text for the SCCS file 

is to be taken. If the -t keyletter is used and admin is creating 
a new SCCS file (the -n and/or -i keyletters also used), the 
descriptive text file name must also be supplied. In the case of 
existing SCCS files: (1) a -t keyletter without a file name 
causes removal of descriptive text (if any) currently in the 
SCCS file, and (2) a -t keyletter with a file name causes text (if 
any) in the named file to replace the descriptive text (if any) 
currently in the SCCS file. 
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-(flag 



b 

cceil 

{floor 

dSID 
Ustr] 



Hist 



<list> 



n 



qtext 

mmod 

ttype 



This keyletter specifies a. flag, and, possibly, a value for the flag, 
to be placed in the SCCS file. Several f keyletters may be sup- 
plied on a single admin command line. The allowable flags and 
their values are: 

Allows use of the -b keyletter on a get (1) command to create 
branch deltas. 

The highest release (i.e., "ceiling"), a number greater than 
but less than or equal to 9999, which may be retrieved by a 
get{\) command for editing. The default value for an 
unspecified c flag is 9999. 

The lowest release (i.e., "floor"), a number greater than but 
less than 9999, which may be retrieved by a get (I) command 
for editing. The default value for an unspecified f flag is 1. 

The default delta number (SID) to be used by a get(l) com- 
mand. 

Causes the "No id keywords (ge6)" message issued by get{\) or 
delta(l) to be treated as a fatal error. In the absence of this flag, 
the message is only a warning. The message is issued if no 
SCCS identification keywords [see get{\)] are found in the text 
retrieved or stored in the SCCS file. If a value is supplied, the 
keywords must exactly match the given string, however the 
string must contain a keyword, and no embedded newlines. 

Allows concurrent get (I) commands for editing on the same 
SID of an SCCS file. This allows multiple concurrent updates to 
the same version of the SCCS file. 

A list of releases to which deltas can no longer be made (get -e 
against one of these "locked" releases fails). The list has the 
following syntax: 

::= <range> | <list> , <range> 
<range>~::= | a 

The character a in the list is equivalent to specifying all releases 
for the named SCCS file. 

Causes deltaiX) to create a "null" delta in each of those releases 
(if any) being skipped when a delta is made in a new release 
(e.g., in making delta 5.1 after delta 2.7, releases 3 and 4 are 
skipped). These null deltas serve as "anchor points" so that 
branch deltas may later be created from them. The absence of 
this flag causes skipped releases to be non-existent in the SCCS 
file, preventing branch deltas from being created from them in 
the future. 

User definable text substituted for all occurrences of the %Q% 
keyword in SCCS file text retrieved by get (1). 

Mod ule name of the SCCS file substituted for all occurrences of 
the %M% keyword in SCCS file text retrieved by get(l). If the 
m flag is not specified, the value assigned is the name of the 
SCCS file with the leading s, removed. 

Type of module in the SCCS file substituted for all occurrences 
of %Y% keyword in SCCS file text retrieved by get (I). 
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vpgm Causes delta(l) to prompt for Modification Request (MR) 

numbers as the reason for creating a delta. The optional value 
specifies the name of an MR number validity checking pro- 
gram [see delta(l)]. (If this flag is set when creating an SCCS 
file, the m keyletter must also be used even if its value is null). 

-dflag Causes removal (deletion) of the specified flag from an SCCS 

file. The -d keyletter may be specified only when processing 
existing SCCS files. Several -d keyletters may be supplied on a 
single admin command. See the -f keyletter for allowable flag 
names. 

Hist A list of releases to be "unlocked". See the -f keyletter for a 

description of the 1 flag and the syntax of a list. 

-dlogin A login name, or numerical UNIX system group ID, to be added 

to the list of users which may make deltas (changes) to the 
SCCS file. A group ID is equivalent to specifying all login 
names common to that group ID. Several a keyletters may be 
used on a single admin command line. As many logins, or 
numerical group IDs, as desired may be on the list simultane- 
ously. If the list of users is empty, then anyone may add del- 
tas. If login or group ID is preceded by a ! they are to be 
denied permission to make deltas. 

-elogin A login name, or numerical group ID, to be erased from the list 

of users allowed to make deltas (changes) to the SCCS file. 
Specifying a group ID is equivalent to specifying all login 
names common to that group ID. Several e keyletters may be 
used on a single admin command line. 

-mlmrlistl The list of Modification Requests (MR) numbers is inserted 

into the SCCS file as the reason for creating the initial delta in a 
manner identical to delta{\). The v flag must be set and the MR 
numbers are validated if the v flag has a value (the name of an 
MR number validation program). Diagnostics will occur if the 
v flag is not set or MR validation fails. 

-ylcomment] The comment text is inserted into the SCCS file as a comment 
for the initial delta in a manner identical to that of deltad). 
Omission of the -y keyletter results in a default comment line 
being inserted in the form: 

date and time created YY /MM / DD HHiMM :SS by login 
The -y keyletter is valid only if the -i and/or -n keyletters are 
specified (i.e., a new SCCS file is being created). 

-h Causes admin to check the structure of the SCCS file [see 

sccsfile(5)\, and to compare a newly computed check-sum (the 
sum of all the characters in the SCCS file except those in the 
first line) with the check-sum that is stored in the first line of 
the SCCS file. Appropriate error diagnostics are produced. 
This keyletter inhibits writing on the file, so that it nullifies the 
effect of any other keyletters supplied, and is, therefore, only 
meaningful when processing existing files. 

-z The SCCS file check-sum is recomputed and stored in the first 

line of the SCCS file (see -h, above). 
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FILES 



SEE ALSO 
DIAGNOSTICS 



Note that use of this keyletter on a truly corrupted file may 
prevent future detection of the corruption. 

The last component of all SCCS file names must be of the form s.file-name. New SCCS 
files are given mode 444 [see chmod(l)]. Write permission in the pertinent directory 
is, of course, required to create a file. All writing done by admin is to a temporary x- 
file, called x.file-name, [see get (I)], created with mode 444 if the admin command is 
creating a new SCCS file, or with the same mode as the SCCS file if it exists. After suc- 
cessful execution of admin, the SCCS file is removed (if it exists), and the x-file is 
renamed with the name of the SCCS file. This ensures that changes are made to the 
SCCS file only if no errors occurred. 

It is recommended that directories containing SCCS files be mode 755 and that SCCS 
files themselves be mode 444. The mode of the directories allows only the owner to 
modify SCCS files contained in the directories. The mode of the SCCS files prevents 
any modification at all except by SCCS commands. 

If it should be necessary to patch an SCCS file for any reason, the mode may be 
changed to 644 by the owner allowing use of ed{\). Care must be taken! The edited file 
should always be processed by an admin -h to check for corruption followed by an 
admin -z to generate a proper check-sum. Another admin -h is recommended to 
ensure the SCCS file is valid. 

admin also makes use of a transient lock file (called x.file-name), which is used to 
prevent simultaneous updates to the SCCS file by different users. See get (I) for 
further information. 

g-file Existed before the execution of delta; removed after completion of 

delta . 
p-file Existed before the execution of delta; may exist after completion of 

delta. 
q-file Created during the execution of delta; removed after completion of 

delta. 
x-file Created during the execution of delta; renamed to SCCS file after 

completion of delta. 
z-file Created during the execution of delta; removed during the execution 

of delta. 
d-file Created during the execution of delta; removed after completion of 

delta. 
/usr/bin/bdiff Program to compute differences between the "gotten" file and the 

g-file. 

delta(l), ed(l), get(l), help(l), prs(l), what(l), sccsfile(4). 
Use helpil) for explanations. 
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NAME 

ansitape - ANSI-standard magtape label program 

ansitape txrc[vqfaei3] [mt=device] 

[vo=volurne-name] [rs=[ r I recordsize]][bs=blocksize] 
[rf=[v I f]][cc=[i If I e]] 
filenamel filename! . . . 



SYNOPSIS 



c 



DESCRIPTION 

ansitape reads, writes, and creates magtapes conforming to the ANSI standard for 
magtape labelling. Primarily, this is useful to exchange tapes with VAX/VMS, which 
makes this kind of tape by default. 

ansitape is controlled by a function key letter (t, x, c, or r). Various options modify the 
format of the output tape. 

Writing ANSI Tapes 

The list of files on the command line is written to the tape. A full Unix pathname 
may be specified, however, only the last pathname component (everything after the 
last /) is used as the filename on the tape. 

Normally, regular text files are to be exchanged, ansitape reads the files one line at a 
time and transfers them to the tape. The newline character at the end of each line is 
removed, and the file is written in a variable-length record format. Variable-format 
files have the length of the longest record specified in a file header. Therefore, ansi- 
tape will read each input file from disk before it goes on to tape, to determine the 
maximum record size. The read is skipped if the file is more than 100,000 bytes long. 
The default carriage control (implied) instructs the other host to restore the newline ^ 

character before printing the record. f 

If ansitape thinks that the input file is a Unix text file (Fortran or implied carriage con- 
trol), it will automatically strip the the Unix newline from the end of each record. No 
strip is done with embedded carriage control files, or with any file using a fixed- 
length record format. 

For binary files, fixed-length records should be used. VAX/VMS normally uses a 
record length of 512 bytes for things like directories and executable files, but data 
files may have any record length. Binary files should be flagged for embedded (rf=e) 
carriage control. 

Reading ANSI Tapes 

When reading, the input file list is presumed to be the names of files to be extracted 
from the tape. The shell wildcard characters asterisk (*) and question-mark (?) may 
be used. Of course, they must be quoted to prevent the shell from interpreting them 
before ansitape sees them. 

None of the options for record format or carriage control need be specified when 
reading files, ansitape will automatically pick up this information from the header 
records on the tape, and do the right thing. If you can't get just what you want from 
ansitape, the resulting files may be run through dd(l). 

FUNCTION LETTERS 

These function letters describe the overall operation desired. One of them must be 
specified in the first argument to ansitape. For lexically rigorous Unix fans, a minus 
sign (-) is allowed, but optional, to introduce the first keyword option set. 



( 
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r Write the named files on the end of the tape. This requires that the tape have 

been previously initialized with an ANSI volume header. 

c Create a new magtape. The tape is initialized with a new ANSI volume 

header. All files previously on the tape are destroyed. This option implies r. 

x Extract all files from the tape. Files are placed in the current directory. Protec- 

tion is r/w to everyone, modified by the current umask(2). 

t List all of the names on the tape. 

MODIFIER KEY LETTERS 

These key letters are part of the first argument to ansitape. 

v Normally ansitape does its work silently; the v (verbose) option displays the 
name of each file ansitape treats, preceded by the function letter. It also 
displays the volume name of each tape as it is mounted. When used with the t 
option, ansitape displays the number of tape blocks used by each file, the 
record format, and the carriage control option. 

q Query before writing anything. On write (c or r options), this causes ansitape 

to ask before writing to the tape. On extract operations, ansitape displays the 
Unix pathname, and asks if it should extract the file. Any response starting 
with a 'y' or 'Y' means yes, any other response (including an empty line) 
means no. 

/ File I/O is done to standard i/o instead. For example, when writing a tape 

file that is to contain a lint listing, we could specify 

lintxyz.c I ansitape rf xyz.lint 

instead of 

lint xyz.c > /tmp/xyz.lint 
ansitape r /tmp/xyz.lint 
rm /tmp/xyz.lint 

When reading, this option causes the extracted files to be sent to stdout 
instead of a disk file. 

a The tape should be read or written with the ASCII character set. This is the 

default. 

e The tape should be written with the EBCDIC character set. The mapping is 

the same one used by the dd(l) program with conv-ebcdic. This option is 
automatically enabled if IBM-format labels are selected. 

i Use IBM-format tape labels. The IBM format is very similar, but not identical, 

to the ANSI standard. The major difference is that the tape will contain no 
HDR3 or HDR4 records, thus restricting the name of the files on the tape to 17 
characters. This option automatically selects the EBCDIC character set for out- 
put. To make an IBM-format label on a tape using the ASCII character set 
(why?), use the option sequence ia. 

3 Do not write HDR3 or HDR4 labels. The HDR3 label is reserved for the use of 
the operating system that created the file. HDR4 is for overflow of filenames 
that are longer than the 17 characters allocated in the HDR1 label. Not all sys- 
tems process these labels correctly, or even ignore them correctly. This switch 
suppresses the HDR3 and HDR4 labels when the tape is to be transfered to a 
system that would choke on them. 
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FUNCTION MODIFIERS 

Each of these options should be given as a separate argument to ansitape. Multiple 
options may be specified. They must appear as after the key-letter options above, 
and before any filename arguments. 

mt= device 

Select an alternate drive on which the tape is mounted. The default is 
/dev/rmt8. 

vo= volume-name 

Specify the name of the output volume. Normally, this defaults to the first six 
characters of your login name. The string 'UNIX' is used as the default if ansi- 
tape cannot determine your login name. 

rs= recordsize 

Specify the output recordsize in bytes. This is the maximum size in the case of 
variable-format files. This option also turns on the fixed-record-format option. 
Thus, if you want to have variable record sizes with a smaller maximum, you 
must specify 

rs= recordsize rf=v 

When the recordsize is manually given, ansitape does not read disk files to 
determine the maximum record length. 

rs=r This is a variant of the rs- option. This causes ansitape to read all disk files for 
recordsize, regardless of their size. Normally, files larger than 100K bytes are 
not scanned for recordsize. Using this option also implies variable-length 
records. 

frs=blocksize 

Specify the output blocksize, in bytes. As many records as will fit are 
crammed into each physical tape block. ANSI standards limit this to 2048 
bytes (the default), but you may specify more or less. Be advised that specify- 
ing more may prevent some systems from reading the tape. 

rf=v Record format is variable-length. In other words, they are text files. This is 
the default, and should be left alone unless you really know what you're 
doing. 

rf=f Record format is fixed-length. This is usually a bad choice, and should be 
reserved for binary files. This also turns off the newline strip usually done for 
Unix text files. 

cc=i Carriage control implied (default). Unlike Unix text files, where records are 
delimited by a newline character, ANSI files do not normally include the new- 
line as part of the record. Instead, a newline is automatically added to the 
record whenever it is sent to a printing device. 

cc=f Carriage control Fortran. Each line is expected to start with a Fortran 
carriage-control character, ansitape does not insert these characters automati- 
cally, it merely marks the file as having them. This is of limited usefulness. 
(Good opportunity for another ambitious hacker.) 

cc=e Carriage control is embedded. Carriage control characters (if any) are a part 
of the data records. This is usually used in the case of binary data files. 

SEE ALSO 

dd(l), umask(2), mtio(4) 
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AUTHOR 

David S. Hayes, Site Manager, US Army Artificial Intelligence Center. Originally 
developed June 1986. Revised August 1986. This software is in the public domain. 

BUGS 

The r (write) option cannot be used with quarter-inch archive tapes, since these tape 
drives cannot backspace. 

There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

Files with names longer than 80 characters have the name truncated. This is a limita- 
tion of the ANSI labelling standard. If the tape is made without HDR3 and HDR4 
labels (3 or i switch), the name is limited to 17 characters. 

Multi- volume tape sets cannot yet be generated, ansitape will read them just fine, but 
it won't write them. Unix provides no device-independent way to detect a physical 
end-of-tape. It was decided that a 2400-foot limitation was preferrable to device- 
dependence. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 

AUTHOR 

BUGS 



APPLY (1) 



apply ~ apply a command to a set of arguments 
a PPty t "" ac ] t ~ n I command args ... 

Apply runs the named command on each argument arg in turn. Normally arguments 
are chosen singly; the optional number n specifies the number of arguments to be 
passed to command. If n is zero, command is run without arguments once for each arg. 
Character sequences of the form %d in command, where d is a digit from 1 to 9, are 
replaced by the d'th following unused arg. If any such sequences occur, n is ignored, 
and the number of arguments passed to command is the maximum value of d in com- 
mand. The character '%' may be changed by the -a option. 

Examples: 

apply echo * 
is similar to ls(l); 

apply -2 cmp al bl a2 b2 ... 
compares the 'a' files to the V files; 

apply -0 who 12 3 4 5 
runs who(l) 5 times; and 

apply In %1 /usr/joe' * 
links all files in the current directory to the directory /usr/joe. 



sh(l) 



Rob Pike 

Shell metacharacters in command may have bizarre effects; it is best to enclose compli- 
cated commands in single quotes ' \ 

There is no way to pass a literal '%2' if '%' is the argument expansion character. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
AUTHOR 



APR0P0S(1) 



apropos - locate commands by keyword lookup 

apropos keyword ... 

apropos shows which manual sections contain instances of any of the given keywords 
in their title. Each word is considered separately and case of letters is ignored. 
Words which are part of other words are considered; thus, when looking for compile, 
apropos will find all instances of 'compiler' also. Try 



apropos password 



and 



apropos editor 

If the line starts 'name(section) ../ you can do 'man section name' to get the docu- 
mentation for it. Try 'apropos format' and then 'man 3s printf to get the manual on 
the subroutine printf. 

apropos is actually just the -k option to the man(l) command. 



/usr/man/whatis 



man(l), whatis(l), catman(8) 



data base 



William Joy 
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NAME 

SYNOPSIS 

DESCRIPTION 



AR(1) 



ar - archive and library maintainer for portable archives 

ar key [posname] afile [name] ... 

The ar command maintains groups of files combined into a single archive file. Its 
main use is to create and update library files as used by the link editor. It can be 
used, though, for any similar purpose. The magic string and the file headers used by 
ar consist of printable ASCII characters. If an archive is composed of printable files, 
the entire archive is printable. 

When ar creates an archive, it creates headers in a format that is portable across all 
machines. The portable archive format and structure is described in detail in ar(4). 
The archive symbol table [described in ar(4)] is used by the link editor [M(D] to effect 
multiple passes over libraries of object files in an efficient manner. An archive sym- 
bol table may only be created and maintained by ar when the archive contains only 
object files. The archive symbol table is in a specially named file which is always the 
first file in the archive. This file is never mentioned or accessible to the user. The s 
option described below is used to force the symbol table to be rebuilt. 

Unlike command options, the command key is a required part of ar's command line. 
The key (which may begin with a -) is formed with one of the following letters: 
drqtpmx. Arguments to the key, alternatively, are made with one of more of the fol- 
lowing set: vuaibcls. Posname is an archive member name used as a reference point 
in positioning other files in the archive. Afile is the archive file. The names are consti- 
tuent files in the archive file. The meanings of the key characters are as follows: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional character u is used 
with r, then only those files with dates of modification later than the archive 
files are replaced. If an optional positioning character from the set abi is used, 
then the posname argument must be present and specifies that new files are to 
be placed after (a) or before (b or i) posname. Otherwise new files are placed at 
the end. 

q Quickly append the named files to the end of the archive file. Optional posi- 
tioning characters are invalid. The command does not check whether the 
added members are already in the archive. This option is useful to avoid qua- 
dratic behavior when creating a large archive piece-by-piece. 

t Print a table of contents of the archive file. If no names are given, all files in the 
archive are tabled. If names are given, only those files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is 
present, then the -posname argument must be present and, as in r, specifies 
where the files are to be moved. 

x Extract the named files. If no names are given, all files in the archive are 
extracted. In neither case does x alter the archive file. 

The meanings of the key arguments are as follows: 

v Give a verbose file-by-file description of the making of a new archive file from 
the old archive and the constituent files. When used with t, give a long listing 
of all information about the files. When used with x, precede each file with a 
name. 
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AR(1) 



FILES 

SEE ALSO 
NOTES 



c Suppress the message that is produced by default when afile is created. 

1 Place temporary files in the local (current working) directory rather than in the 
default temporary directory, TMPDIR. 

s Force the regeneration of the archive symbol table even if ar(l) is not invoked 
with a command which will modify the archive contents. 

$TMPDIR/* temporary files 

$TMPDIR is usually /usr/tmp but can be redefined by setting the environment vari- 
able TMPDIR [see tempnamQ in trnpnam(3S)]. 

ld(l), strip(l), tmpnam(3S), a.out(4), ar(4). 

If the same file is mentioned twice in an argument list, it may be put in the archive 
twice. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
NOTES 



AS(1) 



as - common assembler 

as [options] [input] output 

Note: This program differs from most UNIX assemblers because it may be used as a 
filter. 

The as command assembles the named file. The following flags may be specified in 
any order: 

-i filename 

Specifies a name for the input filename. (However, the input is still stdin .) 

-o objfile Put the output of the assembly in objfile. By default, the output file name is 
formed by removing the .s suffix, if there is one, from the input file name 
specified with the -i option and appending a .o suffix. If there is no -i 
option, the default output file is named a.out . 

-S Produce on the standard output a disassembled version of the input. 

-V Write the version number of the assembler being run on the standard error 

output. 

cc(l), ld(l), nm(l), strip(l), tmpnam(3S), a.out(4) 

Note: Writing assembly code that correctly uses the floating point or vector units 
involves subtle issues of synchronization that are best left to the compiler. Use of this 
option is strongly discouraged. 

Wherever possible, the assembler should be accessed through a compilation system 
interface program such as cc(l). In this case, the C preprocessor is run, giving a rudi- 
mentary macro and include capability. 



C 
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NAME 
SYNOPSIS 



AT(1) 



DESCRIPTION 



at, batch - execute commands at a later time 

at time [ date ] [ + increment ] 
at-r job... 
sit -I [job...] 

batch 



at and batch read commands from standard input to be executed at a later time, at 
allows you to specify when the commands should be executed, while jobs queued 
with batch will execute when system load level permits, at may be used with the fol- 
lowing options: 

-r Removes jobs previously scheduled with at. 

-1 Reports all jobs scheduled for the invoking user. 

Standard output and standard error output are mailed to the user unless they are 
redirected elsewhere. The shell environment variables, current directory, umask, 
and ulimit are retained when the commands are executed. Open file descriptors, 
traps, and priority are lost. 

Users are permitted to use at if their name appears in the file /usr/lib/cron/at.allow. 
If that file does not exist, the file /usr/lib/cron/at.deny is checked to determine if the 
user should be denied access to at. If neither file exists, only root is allowed to submit 
a job. If atdeny is empty, global usage is permitted. The allow/deny files consist of 
one user name per line. These files can only be modified by the superuser. 

The time may be specified as 1, 2, or 4 digits. One and two digit numbers are taken to 
be hours, four digits to be hours and minutes. The time may alternately be specified 
as two numbers separated by a colon, meaning hour:minute. A suffix am or pm may 
be appended; otherwise a 24-hour clock time is understood. The suffix zulu may be 
used to indicate GMT. The special names noon, midnight, now, and next are also 
recognized. 

An optional date may be specified as either a month name followed by a day number 
(and possibly year number preceded by an optional comma) or a day of the week 
(fully spelled or abbreviated to three characters). Two special "days", today and 
tomorrow are recognized. If no date is given, today is assumed if the given hour is 
greater than the current hour and tomorrow is assumed if it is less. If the given 
month is less than the current month (and no year is given), next year is assumed. 

The optional increment is simply a number suffixed by one of the following: minutes, 
hours, days, weeks, months, or years. (The singular form is also accepted.) 

Thus legitimate commands include: 

at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday 

at and batch write the job number and schedule time to standard error. 

batch submits a batch job. It is almost equivalent to "at now", but not quite. For one, 
it goes into a different queue. For another, "at now" will respond with the error 
message too late. 
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EXAMPLES 



at -r removes jobs previously scheduled by at or batch. The job number is the number 
given to you previously by the at or batch command. You can also get job numbers 
by typing at -1. You can only remove your own jobs unless you are the super-user. 

The at and batch commands read from standard input the commands to be executed 
at a later time. sh(l) provides different ways of specifying standard input. Within 
your commands, it may be useful to redirect standard output. 

This sequence can be used at a terminal: 
batch 

sort filename >outfile 
<control-D> (hold down 'control' and depress 'D') 

This sequence, which demonstrates redirecting standard error to a pipe, is useful in a 
shell procedure (the sequence of output redirection specifications is significant): 

batch «! 

sort filename 2>&cl >outfile I mail loginid 

I 

To have a job reschedule itself, invoke at from within the shell procedure, by includ- 
ing code similar to the following within the shell file: 

echo "sh shellfile" I at 1900 thursday next week 



c 



FILES 



SEE ALSO 
DIAGNOSTICS 



/usr/lib/cron main cron directory 

/usr/lib/cron/at.allow list of allowed users 
/usr/lib/cron/at.deny list of denied users 
/usr/lib/cron/queue scheduling information 
/usr/spool/cron/atjobsspool area 

cron(lM), kill(l), mail(l), nice(l), ps(l), sh(l), sort(l), queuedefs(4) 

Complains about various syntax errors and times out of range. 



( 
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DESCRIPTION 



AWK(1) 



awk - pattern scanning and processing language 

awk [-F re] [parameter...] ['prog'] [-iprogfile] [file...] 

awk is a new version of oawk that provides capabilities unavailable in previous ver- 
sions. This version will become the default version of awk in the next major UNIX 
system release. 

The -F re option defines the input field separator to be the regular expression re. 

Parameters, in the form x=... y=... may be passed to awk, where x and y are awk built- 
in variables (see list below). 

awk scans each input file for lines that match any of a set of patterns specified in prog. 
The prog string must be enclosed in single quotes (') to protect it from the shell. For 
each pattern in prog there may be an associated action performed when a line of a file 
matches the pattern. The set of pattern-action statements may appear literally as prog 
or in a file specified with the -f progfile option. 

Input files are read in order; if there are no files, the standard input is read. The file 
name - means the standard input. Each input line is matched against the pattern 
portion of every pattern-action statement; the associated action is performed for each 
matched pattern. 

An input line is normally made up of fields separated by white space. (This default 
can be changed by using the FS built-in variable or the -F re option.) The fields are 
denoted $1, $2, . . . ; $0 refers to the entire line. 

A pattern-action statement has the form: 

pattern { action } 

Either pattern or action may be omitted. If there is no action with a pattern, the 
matching line is printed. If there is no pattern with an action, the action is performed 
on every input line. 

Patterns are arbitrary Boolean combinations ( !, II, &&, and parentheses) of rela- 
tional expressions and regular expressions. A relational expression is one of the fol- 
lowing: 

expression relop expression 
expression matchop regular expression 

where a relop is any of the six relational operators in C, and a matchop is either ~ 
(contains) or ! ~ (does not contain). A conditional is an arithmetic expression, a rela- 
tional expression, the special expression 

var in array, 

or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control before the first 
input line has been read and after the last input line has been read respectively. 

Regular expressions are as in egrep [see grep(l)]. In patterns they must be sur- 
rounded by slashes. Isolated regular expressions in a pattern apply to the entire line. 
Regular expressions may also occur in relational expressions. A pattern may consist 
of two patterns separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and the next occurrence of the second 
pattern. 
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A regular expression may be used to separate fields by using the -F re option or by I 

assigning the expression to the built-in variable FS. The default is to ignore leading ^- 

blanks and to separate fields by blanks and/or tab characters. However, if FS is 
assigned a value, leading blanks are no longer ignored. 

Other built-in variables include: 

ARGC command line argument count 

ARGV command line argument array 

FILENAME name of the current input file 

FNR ordinal number of the current record in the current file 

FS input field separator regular expression (default blank) 

NF number of fields in the current record 

NR ordinal number of the current record 

OFMT output format for numbers (default %.6g) 

OFS output field separator (default blank) 

ORS output record separator (default new-line) 

RS input record separator (default new-line) 

An action is a sequence of statements. A statement may be one of the following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement | 

for ( var in array ) statement V 

delete array[subscript] 

break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit [expr] # skip the rest of the input; exit status is expr 

return [expr] 

Statements are terminated by semicolons, new-lines, or both. An empty expression- 
list stands for the whole input line. Expressions take on string or numeric values as 
appropriate, and are built using the operators +, -, *, /, %, and concatenation (indi- 
cated by a blank). The C operators ++, — , +=, -=, *=, /=, and %= are also available in 
expressions. Variables may be scalars, array elements (denoted x[i]), or fields. Vari- 
ables are initialized to the null string or zero. Array subscripts may be any string, 
not necessarily numeric; this allows for a form of associative memory. String con- 
stants are quoted ( ,f ). 

The print statement prints its arguments on the standard output, or on a file if 
expression is present, or on a pipe if I cmd is present. The arguments are separated 
by the current output field separator and terminated by the output record separator. 
The printf statement formats its expression list according to the format [see printf OS) 
in the Programmer's Reference Manual] . 



( 
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awk has a variety of built-in functions: arithmetic, string, input/output, and general. 

The arithmetic functions are: atanl, cos, exp, int, log, rani, sin, sqrt, and stand, int trun- 
cates its argument to an integer, rand returns a random number between and 1. 
srand ( expr ) sets the seed value for rand to expr or uses the time of day if expr is omit- 
ted. 

The string functions are: 

gsub(for, repl, in) 

behaves like sub (see below), except that it replaces successive 
occurrences of the regular expression (like the ed global substitute 
command). 

index(s, t) returns the position in string s where string t first occurs, or if it 

does not occur at all. 

length(s) returns the length of its argument taken as a string, or of the whole 

line if there is no argument. 

rnatchis, re) returns the position in string s where the regular expression re 
occurs, or if it does not occur at all. RSTART is set to the starting 
position (which is the same as the returned value), and RLENGTH is 
set to the length of the matched string. 

split(s 9 a,fs) splits the string s into array elements a[l], a[2], a[n], and returns n. 
The separation is done with the regular expression fs or with the 
field separator FS if fs is not given. 

sprintfifmt, expr, expr, . . .) 

formats the expressions according to the printf (3S) format given by 
fmt and returns the resulting string. 

subifor, repl, in) substitutes the string repl in place of the first instance of the regular 
expression for in string in and returns the number of substitutions. If 
in is omitted, awk substitutes in the current record ($0). 

substr(s, m, n) returns the n -character substring of s that begins at position m . 

The input/output and general functions are: 

close (filename) closes the file or pipe named filename. 

cmd I getline pipes the output of cmd into getline; each successive call to getline 
returns the next line of output from cmd. 

getline sets $0 to the next input record from the current input file. 

getline <file sets $0 to the next record from file. 

getline var sets variable var instead. 

getline var <file sets var from the next record of file. 

system (cmd ) executes cmd and returns its exit status. 

All forms of getline return 1 for successful input, for end of file, and -1 for an error. 

awk also provides user-defined functions. Such functions may be defined (in the pat- 
tern position of a pattern-action statement) as 

function name(args,...) { stmts } 
func name(args,...) { stmts } 

Function arguments are passed by value if scalar and by reference if array name. 
Argument names are local to the function; all other variable names are global. Func- 
tion calls may be nested and functions may be recursive. The return statement may 
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EXAMPLES 



SEE ALSO 
BUGS 



be used to return a value. 

Print lines longer than 72 characters: 

length > 72 
Print first two fields in opposite order: 

{ print $2, $1 } 
Same, with input fields separated by comma and/or blanks and tabs: 

BEGIN { FS = ",[ \t]* I [ \t]+" } { print $2, $1 } 

Add up first column, print sum and average: 

{ s += $1 } 
END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; — i) print $i } 
Print all lines between start/stop pairs: 

/start/, /stop/ 
Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 
Simulate echo(l): 

BEGIN { for (i = 1; i < ARGC; i++) printf "%s", ARGV[i] printf "\n" 
exit 
} 
Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 
{ print } 

command line: awk -f program n=5 input 

grep(l), lex(l), oawk(l), printf(3S), sed(l) 

Input white space is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To force an expres- 
sion to be treated as a number add to it; to force it to be treated as a string concaten- 
ate the null string ("") to it. 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 

SEE ALSO 



BANNER (1) 



banner - make posters 



banner strings 



c 



banner prints its arguments (each up to 10 characters long) in large letters on the stan- 
dard output. 

echo(l). 



c 
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NAME 
SYNOPSIS 

DESCRIPTION 



EXAMPLES 



SEE ALSO 
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basename, dirname - deliver portions of path names 

basename string [ suffix ] 
dirname string 

basename deletes any prefix ending in / and the suffix (if present in string) from string, 
and prints the result on the standard output. It is normally used inside substitution 
marks ( v s ) within shell procedures. 

Dirname delivers all but the last level of the path name in string. 

The following example, invoked with the argument /usr/src/cmd/catc, compiles the 
named file and moves the output to a file named cat in the current directory: 

cc $1 

mv a.out v basename $1 '\.c v 

The following example will set the shell variable NAME to /usr/src/cmd: 

NAME= V dirname /usr/src/cmd/cat.c v 



sh(l). 
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be - arbitrary-precision arithmetic language 

bc[-c][-l][file...] 

be is an interactive processor for a language that resembles C but provides unlimited 
precision arithmetic. It takes input from any files given, then reads the standard 
input. The bc(l) utility is actually a preprocessor for dc(l), which it invokes automat- 
ically unless the -c option is present. In this case the dc input is sent to the standard 
output instead. The options are as follows: 

-c Compile only. The output is send to the standard output. 

-1 Argument stands for the name of an arbitrary precision math library. 

The syntax for be programs is as follows; L means letter a-z, E means expression, S 
means statement. 

Comments 

are enclosed in /* and */. 

Names 

simple variables: L 

array elements: L [ E ] 

The words "ibase", "obase", and "scale" 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 
(E) 



c 



sqrt ( E ) 
length ( E ) 
scale ( E ) 
L(E,...,E) 



number of significant decimal digits 
number of digits right of decimal point 



c 



Operators 
+ 



_ * / % a (% i s remainder; A is power) 
++ — (prefix and postfix; apply to names) 

= =+ =- =* =/=% =A 

Statements 
E 

{S;...;S} 
if(E)S 
while ( E ) S 
for ( E ; E ; E ) S 
null statement 
break 
quit 

Function definitions 

define L ( L ,..., L ) { 

auto L, ... , L 

S; ... S 

return ( E ) 
} 



( 
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EXAMPLE 



FILES 

SEE ALSO 
BUGS 



-1 math library 
sine 
cosine 
exponential 
log 

arctangent 
Bessel function 



Functions in - 
s(x) 
c(x) 
e(x) 
Kx) 
a(x) 
j(n,x) 

All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the main operator is 
an assignment. Either semicolons or new-lines may separate statements. Assign- 
ment to scale influences the number of digits to be retained on arithmetic operations 
in the manner of dc{\). Assignments to ibase or obase set the input and output 
number radix respectively. 

The same letter may be used as an array, a function, and a simple variable simultane- 
ously. All variables are global to the program. "Auto" variables are pushed down 
during function calls. When using arrays as function arguments or defining them as 
automatic variables, empty square brackets must follow the array name. 

scale = 20 
define e(x){ 

auto a, b, c, i, s 
a = l 
b = l 
s = l 

for(i=l;l==l;i++){ 
a = a*x 
b = b*i 
c = a/b 

if(c ==0) return(s) 
s = s+c 
} 
} 

defines a function to compute an approximate value of the exponential function and 

for(i=l; i<=10; i++) eft) 

prints approximate values of the exponential function of the first ten integers. 

/usr/lib/lib.b mathematical library 
/usr/bin/dc desk calculator proper 

dc(l). 

The be command does not yet recognize the logical operators, && and I I . 
For statement must have all three expressions (E's). 
Quit is interpreted when read, not when executed. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



BCHECKRC(IM) 



bcheckrc - system initialization procedures 

/etc/bcheckrc 

These shell procedures are executed via entries in /etc/inittab by init (1M) whenever 
the system is booted (or rebooted). 

First, the bcheckrc procedure checks the status of the root file system. If the root file 
system is found to be bad, bcheckrc repairs it. 

Then, it clears the mounted file system table, /etc/mnttab, and puts the entry for the 
root file system into the mount table. 

After these two procedures have executed, init checks for the initdefault value in 
/etc/inittab. This tells init in which run level to place the system. Since initdefault is 
initially set to 2, the system will be placed in the multi-user state via the /etc/rc2 pro- 
cedure. 

Also, these shell procedures may be used for several run-level states. 
fsck(lM), init(lM), rc2(8), shutdown(lM) 



( 
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FILES 

SEE ALSO 

DIAGNOSTICS 



BDIFF(1) 



bdiff-bigdiff 

bdiff filel file2 [n] [-s] 

bdiff is used in a manner analogous to diff(\) to find which lines in two files must be 
changed to bring the files into agreement. Its purpose is to allow processing of files 
which are too large for diff. 

The parameters to bdiff axe: 

filel (filel) 

The name of a file to be used, If filel (filel) is - the standard input is read. 

n The number of line segments. The value of n is 3500 by default. If the optional 
third argument is given and it is numeric, it is used as the value for n. This is 
useful in those cases in which 3500-line segments are too large for diff, causing 
it to fail. 

-s Specifies that no diagnostics are to be printed by bdiff (silent option). Note, 
however, that this does not suppress possible diagnostic messages from diff (I), 
which bdiff calls. 

bdiff ignores lines common to the beginning of both files, splits the remainder of each 
file into n-line segments, and invokes diff upon corresponding segments. If both 
optional arguments are specified, they must appear in the order indicated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to account for 
the segmenting of the files (that is, to make it look as if the files had been processed 
whole). Note that because of the segmenting of the files, bdiff does not necessarily 
find a smallest sufficient set of file differences. 

/tmp/bd????? 

diff(l),help(l). 

Use help (I) for explanations. 
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bf s - big file scanner 

bf s [ - ] name 

The bfs command is (almost) like ed{\) except that it is read-only and processes much 
larger files. Files can be up to 1024K bytes and 32K lines, with up to 512 characters, 
including new-line, per line, bfs is usually more efficient than ed{\) for scanning a 
file, since the file is not copied to a buffer. It is most useful for identifying sections of 
a large file where c$plit(l) can be used to divide it into more manageable pieces for 
editing. 

Normally, the size of the file being scanned is printed, as is the size of any file written 
with the w command. The optional - suppresses printing of sizes. Input is 
prompted with * if P and a carriage return are typed, as in ed(l). Prompting can be 
turned off again by inputting another P and carriage return. Note that messages are 
given in response to errors if prompting is turned on. 

All address expressions described under ed{l) are supported. In addition, regular 
expressions may be surrounded with two symbols besides / and ?: > indicates down- 
ward search without wrap-around, and < indicates upward search without wrap- 
around. There is a slight difference in mark names: only the letters a through z may 
be used, and all 26 marks are remembered. 

The e, g, v, k, p, q, w, =, ! and null commands operate as described under ed(l). 

Commands such as , +++-, +++=, -12, and +4p are accepted. Note that l,10p 

and 1,10 will both print the first ten lines. The f command only prints the name of 
the file being scanned; there is no remembered file name. The w command is indepen- 
dent of output diversion, truncation, or crunching (see the xo, xt and xc commands, 
below). The following additional commands are available: 

xf file 

Further commands are taken from the named file. When an end-of-file is 
reached, an interrupt signal is received or an error occurs, reading 
resumes with the file containing the xf . The xf commands may be nested 
to a depth of 10. 

xn List the marks currently in use (marks are set by the k command). 

xo[file] 

Further output from the p and null commands is diverted to the named 
file, which, if necessary, is created mode 666 (readable and writable by 
everyone), unless your umask setting (see umask(l)) dictates otherwise. If 
file is missing, output is diverted to the standard output. Note that each 
diversion causes truncation or creation of the file. 



; label 



This positions a label in a command file. The label is terminated by new- 
line, and blanks between the : and the start of the label are ignored. This 
command may also be used to insert comments into a command file, since 
labels need not be referenced. 

, )xb /regular expression /label 
A jump (either upward or downward) is made to label if the command 



c 
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succeeds. It fails under any of the following conditions: 1. Either address 
is not between 1 and $. 

2. The second address is less than the first. 

3. The regular expression does not match at least one line in the 
specified range, including the first and last lines. 

On success, . is set to the line matched and a jump is made to label. This 
command is the only one that does not issue an error message on bad 
addresses, so it may be used to test whether addresses are bad before 
other commands are executed. Note that the command 

xb/ A / label 

is an unconditional jump. 

The xb command is allowed only if it is read from someplace other than a 

terminal. If it is read from a pipe only a downward jump is possible. 

xt number 

Output from the p and null commands is truncated to at most number 
characters. The initial number is 255. 

xv[digit] [spaces] [value] 

The variable name is the specified digit following the xv. The commands 
xv5100 or xv5 100 both assign the value 100 to the variable 5. The com- 
mand xv61,100p assigns the value l,100p to the variable 6. To reference a 
variable, put a % in front of the variable name. For example, using the 
above assignments for variables 5 and 6: 

l,%5p 

1,%5 

%6 

will all print the first 100 lines. 

g/%5/p 

would globally search for the characters 100 and print each line contain- 
ing a match. To escape the special meaning of %, a \ must precede it. 

g/".*\%[cds]/p 

could be used to match and list lines containing printf of characters, 
decimal integers, or strings. 

Another feature of the xv command is that the first line of output from a 
UNIX system command can be stored into a variable. The only require- 
ment is that the first character of value be an !. For example: 

.w junk 
xv5!cat junk 
!rm junk 
!echo "%5" 
xv6!expr %6 + 1 

would put the current line into variable 5, print it, and increment the vari- 
able 6 by one. To escape the special meaning of ! as the first character of 
value, precede it with a \. 
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xv7\!date 
stores the value Idate into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from the execu- 
tion of a UNIX system command (kommand) or nonzero value, respec- 
tively, to the specified label. The two examples below both search for the 
next five lines containing the string size. 

xv55 

:1 

/size/ 

xv5!expr %5 - 1 

!if0%5!=0exit2 

xbnl 

xv45 

:1 

/size/ 

xv4!expr %4 - 1 

!if 0%4 = exit 2 

xbzl 

xc [switch] 

If switch is 1, output from the p and null commands is crunched; if switch 
is it is not. Without an argument, xc reverses switch Initially switch is s~ 

set for no crunching. Crunched output has strings of tabs and blanks I 

reduced to one blank and blank lines suppressed. 

SEE ALSO 

csplit(l), ed(l), umask(l). 

DIAGNOSTICS 

? for errors in commands, if prompting is turned off. Self-explanatory error mes- 
sages when prompting is on. 



c 



42 Stardent 1500/3000 



Essential Utilities 



BIFF(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



BIFF(1) 



biff - be notified if mail arrives and who it is from - 

biff[yn] 

Biff informs the system whether you want to be notified when mail arrives during the 
current terminal session. The command 

biffy 

enables notification; the command 

biffn 

disables it. When mail notification is enabled, the header and first few lines of the 
message will be printed on your screen whenever mail arrives. A "biff y" command 
is often included in the file .login or .profile to be executed at each login. 

Biff operates asynchronously. For synchronous notification use the MAIL variable of 
sh(l) or the mail variable of csh(l). 

csh(l), sh(l), mail(l), comsat(8C) 
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CAL(1) 



cal - print calendar 

cal [ [ month ] year ] 

cal prints a calendar for the specified year. If a month is also specified, a calendar just 
for that month is printed. If neither is specified, a calendar for the present month is 
printed. Year can be between 1 and 9999. The month is a number between 1 and 12. 
The calendar produced is that for England and the United States. 

An unusual calendar is printed for September 1752. That is the month 11 days were 
skipped to make up for lack of leap year adjustments. To see this calendar, type: cal 
9 1752 

The year is always considered to start in January even though this is historically 

naive. 

Beware that "cal 83" refers to the early Christian era, not the 20th century. 
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NAME 

calendar - reminder service 

calendar [ - ] 

calendar consults the file calendar in the current directory and prints out lines that 
contain today's or tomorrow's date anywhere in the line. Most reasonable month- 
day dates such as "Aug. 24," "august 24," "8/24," etc., are recognized, but not "24 
August" or "24/8". On weekends "tomorrow" extends through Monday. 

When an argument is present, calendar does its job for every user who has a file 
calendar in his or her login directory and sends them any positive results by mail{\). 
Normally this is done daily by facilities in the UNIX operating system. 

/usr/lib/calprog to figure out today's and tomorrow's dates 
/etc/passwd 

/tmp/cal* 

mail(l). 

Your calendar must be public information for you to get reminder service. 
calendar's extended idea of "tomorrow" does not account for holidays. 



FILES 



SEE ALSO 
BUGS 
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captoinfo - convert a termcap description into a terminfo description 

captoinfo [-v ...] [-V] [-1] [~w width] file ... 

captoinfo looks in file for termcap descriptions. For each one found, an equivalent ter- 
minfo (A) description is written to standard output, along with any comments found. 
A description which is expressed as relative to another description (as specified in 
the termcap tc= field) will be reduced to the minimum superset before being output. 

If no file is given, then the environment variable TERMCAP is used for the filename or 
entry. If TERMCAP is a full pathname to a file, only the terminal whose name is 
specified in the environment variable TERM is extracted from that file. If the 
environment variable TERMCAP is not set, then the file /etcftermcap is read. 

-v print out tracing information on standard error as the program runs. 

Specifying additional -v options will cause more detailed information to 
be printed. 

-V print out the version of the program in use on standard error and exit. 

-1 cause the fields to print out one to a line. Otherwise, the fields will be 

printed several to a line to a maximum width of 60 characters. 

-w change the output to width characters. 

/usr/lib/terminfo/?/* compiled terminal description database 

Certain termcap defaults are assumed to be true. For example, the bell character (ter- 
minfo bel) is assumed to be A G. The linefeed capability (termcap nl) is assumed to be 
the same for both cursor __down and scroll Jorward (terminfo cudl and ind, respectively.) 
Padding information is assumed to belong at the end of the string. 

The algorithm used to expand parameterized information for termcap fields such as 
cursor ^position (termcap cm, terminfo cup) will sometimes produce a string which, 
though technically correct, may not be optimal. In particular, the rarely used termcap 
operation %n will produce strings that are especially long. Most occurrences of these 
non-optimal strings will be flagged with a warning message and may need to be 
recoded by hand. 

The short two-letter name at the beginning of the list of names in a termcap entry, a 
hold-over from an earlier version of the UNIX system, has been removed. 

tgetent failed with return code n (reason). 

The termcap entry is not valid. In particular, check for an invalid 
'tc=' entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose type was not 
boolean, numeric or string. 

wrong type given for the boolean (numeric, string) termcap code cc. 

The boolean termcap entry cc was entered as a numeric or string 
capability. 

the boolean (numeric, string) termcap code cc is not a valid name. 
An unknown termcap code was specified. 
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SEE ALSO 
NOTES 



tgetent failed on TERM=term. 

The terminal type specified could not be found in the termcap file. 

TERM=term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The correct way to 
cancel an entry is with an '@' ' , as in ':bs@:'. Giving a null string could 
cause incorrect assumptions to be made by the software which uses 
termcap or terminfo. 

a function key for cc was specified, but it already has the value vv. 

When parsing the ko capability, the key cc was specified as having 
the same value as the capability cc, but the key cc already had a value 
assigned to it. 

the unknown termcap name cc was specified in the ko termcap capability. 

A key was specified in the ko capability which could not be handled. 

the vi character v (info ii) has the value xx, but ma gives n. 

The ma capability specified a function key with a value different 
from that specified in another setting of the same key. 

the unknown vi key v was specified in the ma termcap capability. 

A vi{\) key unknown to captoinfo was specified in the ma capability. 

Warning: termcap sg {nn) and termcap ug (nn) had different values. 

terminfo assumes that the sg (now xmc) and ug values were the same. 

Warning: the string produced for ii may be inefficient. 

The parameterized string being created should be rewritten by hand. 

Null termname given. 

The terminal type was null. This is given if the environment variable 
TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 

curses (3X), infocmp(lM), terminfo(4), tic(lM). 

captoinfo should be used to convert termcap entries to terminfo(4d entries because the 
termcap database (from earlier versions of UNIX System V) may not be supplied in 
future releases. 
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cat - concatenate and print files 
cat[-u][-s][-vH][-c]]ffle...- 

cat reads each file in sequence and writes it on the standard output. Thus: 

cat file 
prints the file, and: 

cat filel file2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument - is encountered, cat reads from the stan- 
dard input file. 

The following options apply to cat. 

-u The output is not buffered. (The default is buffered output.) 

-s cat is silent about non-existent files. 

~v Causes non-printing characters (with the exception of tabs, new-lines and 
form-feeds) to be printed visibly. Control characters are printed A X (control-x); 
the DEL character (octal 0177) is printed A ?. Non- ASCII characters (with the 
high bit set) are printed as M-x, where x is the character specified by the seven 
low order bits. 

When used with the -v option, the following options may be used. 

-t Causes tabs to be printed as A I's. 

-e Causes a $ character to be printed at the end of each line (prior to the new-line). 

The -t and -e options are ignored if the -v option is not specified. 

Command formats such as cat filel file2 >filel will cause the original data in filel to 
be lost; therefore, take care when using shell special characters. 

cp(l),pg(l),pr(l). 
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CAT(1B) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



CAT(1B) 



cat - catenate and print 

cat [ -u ] [ -n ] [ -s ] [ -v ] file ... 

cat reads each file in sequence and displays it on the standard output. Thus 

cat file 
displays the file on the standard output, and 

cat filel file2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument '-' is encountered, cat reads from the stan- 
dard input file. Output is buffered in the block size recommended by stat(2) unless 
the standard output is a terminal, when it is line buffered. The -u option makes the 
output completely unbuffered. 

The -n option displays the output lines preceded by lines numbers, numbered 
sequentially from 1. Specifying the -b option with the -n option omits the line 
numbers from blank lines. 

The -s option crushes out multiple adjacent empty lines so that the output is 
displayed single spaced. 

The -v option displays non-printing characters so that they are visible. Control char- 
acters print like A X for control-x; the delete character (octal 0177) prints as A ?. Non- 
ascii characters (with the high bit set) are printed as M- (for meta) followed by the 
character of the low 7 bits. A -e option may be given with the -v option, which 
displays a '$' character at the end of each line. Specifying the -t option with the -v 
option displays tab characters as A I. 

cp(l), ex(l), more(l), pr(l), tail(l) 

Beware of 'cat a b >a' and 'cat a b >b', which destroy the input files before reading 
them. 
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CB(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



BUGS 



CB(1) 



cb - C program beautifier 
cb[-s][-j][-lleng][file...] 

The cb comand reads C programs either from its arguments or from the standard 
input, and writes them on the standard output with spacing and indentation that 
display the structure of the code. Under default options, cb preserves all user new- 
lines. 

cb accepts the following options. 

-s Canonicalizes the code to the style of Kernighan and Ritchie in The C 



c 



Programming Language. 
-j Causes split lines to be put back together. 

-1 leng Causes cb to split lines that are longer than leng. 

cc(l). 

The C Programming Language. Prentice-Hall, 1978. 

Punctuation that is hidden in preprocessor statements will cause indentation errors. 
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CC(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



CC(1) 



cc - C compiler 



cc [ options ] [ files ] [ options ] [ files ] 



The cc command is an interface to the Stardent 1500/3000 Compilation System. The 
compilation tools consist of a preprocessor, compiler, beautifier, assembler, and link 
editor. The cc command processes the supplied options and then executes the vari- 
ous tools with the proper arguments. The cc command accepts several types of files 
as arguments: 

Files whose names end with .c are taken to be C source programs and may be 
preprocessed, compiled, optimized, assembled, and link edited. The compilation 
process may be stopped after the completion of any pass if the appropriate options 
are supplied. If the compilation process runs through the assembler then an object 
program is produced and is left in the file whose name is that of the source with .o 
substituted for .c. However, the .o file is normally deleted if a single C program is 
compiled and then immediately link edited. In the same way, files whose names end 
in .s are taken to be assembly source programs, and may be assembled and link 
edited; and files whose names end in i are taken to be preprocessed C source pro- 
grams and may be compiled, optimized, assembled and link edited. Files whose 
names do not end in .c, .s or a are handed to the link editor. 

Since the cc command usually creates files in the current directory during the compi- 
lation process, it is necessary to run the cc command in a directory in which a file can 
be created. 

The following options are interpreted by cc: 

-c Suppress the link editing phase of the compilation, and do not remove any pro- 
duced object files. 

-cpp Invoke the C preprocessor on the source file before compiling. 

-cross_reference 

Generate a cross-reference, if a listing is generated. 

-Dname 

Define name to have the value of 1, to the preprocessor. 

-Dname=val 

Define name to have the value of vol, to the preprocessor. 

-debug 

Add debug data to the object file. Force optimization level to zero. This is 
synonymous with -g. 

-E Run only cpp(\) on the named C programs, and send the result to the standard 
output. 

-full_report 

Produce a detailed vectorizer report. 

-fullsub check 

Generate code to check that every subscript in every array reference is within t 
he bounds of the appropriate array dimensions. 

-g Generate additional information needed for the use of dbg(l). Force optimiza- 
tion level to zero. This option is synonymous with -debug. 
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-I Suppress the default searching for preprocessor included files in jusr /include. t 

-Idir Search for include files in dir. 

-i Suppress the automatic production of #ident information. 

-inline 

Instruct the compiler to enable function inlining. 

-Npaths=naraean 

Instruct the compiler to make use of the database of functions listed in the cata- 
log name.in as the source for inlining. 

-NW 

Suppress compiler warnings. 

-n Suppress the standard C startup routine. 

-O0 Turn off all optimizations. 

-Ol Perform common subexpression elimination and instruction scheduling. If 
nothing is specified, this -Ol is the default setting of compiler optimization 
level. 

-02 Perform -Ol and vectorization. 

-03 Perform -02 and parallelization. 

-O This is synonymous with -Ol. 

-o filename 



Place the output into filename. 

-P Run only cpp(l) on the named C programs and and leave the result in 
corresponding files suffixed .i. This option is passed to cpp(l). 

-p Generate code to profile the loaded program during execution. (See prqf(l) and 
mkprofd).) 

-ploop 

Generate code which allows loops within a single routine to be profiled 
separately. 

-r Produce a relocatable output file. 

-S Compile and do not assemble the named C programs, and leave the assembler 
output in corresponding files suffixed .s. 

-safe=loops 

Guarantee that all for loops within the program have upper bounds that do not 
vary within the loop. 

-safe=parms 

Declare that input arguments do not have hidden aliases. 

-safe=ptrs 

Declare that pointers do not have hidden aliases. 

-subcheck 

Produce code to check at runtime to ensure that each array element accessed is 
actually part of the appropriate array. However, at optimization level 02 and 
higher, this option ignores the vector mask. This means that some operations 
may generate subscriptranges that are not actually in the code. 

-Uname 

Undefine name. 
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CC(1) 



F!LES 



-V Print version information. 

-v Generate more messages tracking the progress of the compilation. 

-vector_c 

This is equivalent to specifying -safe=parms -safe=loops. 

-vreport 

Invoke the vector reporting facility and tell the user what vectorization has 
been done. A detailed listing is provided for each loop nest and suggestions for 
achieving better performance are included. 

-vsummary 

Invoke the vector reporting facility and tell the user what vectorization has 
been done. Print out what statements are and are not vectorized in each loop. 
This output is in Fortran-like notation. 

Suppress warning messages during compilation. 

Use this option to get 4.3 BSD header files and libraries. 

The cc command recognizes -B hhhhhhh, -D hhhhhhh, -esym, -L, -Ldfr, Atag, -m, -N, 
-ofilename, -opct, -p, -r, -s, -T hhhhhhh, -t, -unarm, and -yname and passes these 
options and their arguments directly to the loader. See the manual pages for cpp(l) 
and ld{\) for descriptions. 

Other arguments are taken to be C compatible object programs, typically produced 
by an earlier cc run, or perhaps libraries of C compatible routines and are passed 
directly to the link editor. These programs, together with the results of any compila- 
tions specified, are link edited (in the order given) to produce an executable program 
with name a.out. 



-w 



-43 



file.c 

file.o 

file.s 

a.out 

/lib/crtO.o 

TMPDIR/* 

/lib/cpp 

/bin/as 

/bin/Id 

/lib/libca 



C source file 
object file 

assembly language file 
link edited output 
start-up routine 
temporary files 
preprocessor, cpp(l) 
assembler, as (I) 
link editor, Id (I) 
standard C library 



SEE ALSO 



NOTES 



TMPDIR is usually /usr/tmp but can be redefined by setting the environment vari- 
able TMPDIR [see ternpnarnO in tmpnam(3S)]. 

as(l), dbg(l), ld(l), cpp(l), mkprof(l), prof(l) 

Kernighan, B. W., and Ritchie, D. M., The C Programming Language, Prentice-Hall, 
1978. Harbison, S. P., and Steele, G. L. Jr., C: A Reference Manual, Prentice-Hall, 
Second Edition, 1987. 

By default, the return value from a compiled C program is completely random. The 
only two guaranteed ways to return a specific value is to explicitly call exit (2) or to 
leave the function main() with a "return expression;" construct. 
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NAME 

cd - change working directory 

cd [ directory ] 

If directory is not specified, the value of shell parameter $HOME is used as the new 
working directory. If directory specifies a complete path starting with /, ., . ., directory 
becomes the new working directory. If neither case applies, cd tries to find the desig- 
nated directory relative to one of the paths specified by the $CDPATH shell variable. 
$CDPATH has the same syntax as, and similar semantics to, the $PATH shell variable. 
cd must have execute (search) permission in directory . 

Because a new process is created to execute each command, cd would be ineffective if 
it were written as a normal command; therefore, it is recognized and is internal to the 
shell. 

SEE ALSO 

csh(l),pwd(l),sh(l) 

chdir(2) in the Programmer' '$ Reference Manual 
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CDC(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



CDC(1) 



cdc - change the delta commentary of an SCCS delta 

cdc -rSID [-m[mrlist]] [-y [comment]] files 

cdc changes the delta commentary, for the SID (SCCS IDentification string) specified 
by the -r keyletter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request (MR) and comment infor- 
mation normally specified via the delta{\) command (~m and -y keyletters). 

If a directory is named, cdc behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a name of - is 
given, the standard input is read (see WARNINGS) and each line of the standard input 
is taken to be the name of an SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of keyletter arguments and 
file names. 

All the described keyletter arguments apply independently to each named file: 

-tSID Used to specify the SCCS IDentification (SID) string of a delta 

for which the delta commentary is to be changed. 

-mmrlist If the SCCS file has the v flag set [see admin(l)] then a list of MR 

numbers to be added and/or deleted in the delta commentary 
of the SID specified by the -r keyletter may be supplied. A null 
MR list has no effect. 

MR entries are added to the list of MRs in the same manner as 
that of delta(l). In order to delete an MR, precede the MR 
number with the character ! (see EXAMPLES). If the MR to be 
deleted is currently in the list of MRs, it is removed and 
changed into a "comment" line. A list of all deleted MRs is 
placed in the comment section of the delta commentary and 
preceded by a comment line stating that they were deleted. 

If -m is not used and the standard input is a terminal, the 
prompt MRs? is issued on the standard output before the stan- 
dard input is read; if the standard input is not a terminal, no 
prompt is issued. The MRs? prompt always precedes the com- 
ments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. 
An unescaped new-line character terminates the MR list. 

Note that if the v flag has a value [see admin(l)], it is taken to 
be the name of a program (or shell procedure) which validates 
the correctness of the MR numbers. If a non-zero exit status is 
returned from the MR number validation program, cdc ter- 
minates and the delta commentary remains unchanged. 

-ylcomment] Arbitrary text used to replace the comment {s) already existing 
for the delta specified by the -r keyletter. The previous com- 
ments are kept and preceded by a comment line stating that 
they were changed. A null comment has no effect. 
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CDC(1) 



CDC(1) 



EXAMPLES 



WARNINGS 

FILES 

SEE ALSO 
DIAGNOSTICS 



If -y is not specified and the standard input is a terminal, the 
prompt comments? is issued on the standard output before 
the standard input is read; if the standard input is not a termi- 
nal, no prompt is issued. An unescaped new-line character 
terminates the comment text. 

Simply stated, the keyletter arguments are either (1) if you made the delta, you can 
change its delta commentary; or (2) if you own the file and directory you can modify 
the delta commentary. 

cdc -rl.6 -m"bl7842345 M77-54321 bl79-0000r -ytrouble siile 

adds M78-12345 and bl79-00001 to the MR list, removes bl77-54321 from the MR list, 
and adds the comment trouble to delta 1.6 of s.file. 

cdc -rl.6 s.file 

MRs? !bl77-54321 W78-12345 bl79-00001 

comments? trouble 

does the same thing. 

If SCCS file names are supplied to the cdc command via the standard input (- on the 
command line), then the -m and -y keyletters must also be used. 



x-file 
z-file 



[see delta (1)] 
[see deltad)] 



c 



admin(l), delta(l), get(l), help(l), prs(l), sccsfile(4). 
Use help(l) for explanations. 
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NAME 

chfn - change finger entry 

chfn [name] 

chfn is used to change information about users. The information is stored in the 
/etc/passxvd file and used by finger (1). It is equivalent to passwd -/. chfn prompts the 
user for information for each field. Included in the prompt string is the current value 
for the field enclosed in brackets. Accept the default value by typing a carriage 
return. Enter a blank field by typing none. Here's a sample session: 

Changing finger information for paul . 

Default values are printed inside of ' []' . 

To accept the default , type <return>. 

To have a blank entry, type the word 'none'. 

Name [Paul Anthony] : 

Office [] : 

Office Phone [555] : 666 

Home Phone [4085551211]: 408-555-1212 
The optional argument name is used to change another person's finger information. 
This can only be done by the super-user. 

/etc/passwd 

finger(l), passwd(5) 



FILES 
SEE ALSO 
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NAME 
SYNOPSIS 

DESCRIPTION 



CHM0D(1) 



chmod - change mode 

chmod mode file ... 
chmod mode directory ... 

The permissions of the named files or directories are changed according to mode, 
which may be symbolic or absolute. Absolute changes to permissions are stated 
using octal numbers: 

chmod nnnfile(s) 

where n is a number from to 7. Symbolic changes are stated using mnemonic char- 
acters: 

chmod a operator b file(s) 

where a is one or more characters corresponding to user, group, or other; where 
operator is +, -, and =, signifying assignment of permissions; and where b is one or 
more characters corresponding to type of permission. 

An absolute mode is given as an octal number constructed from the OR of the follow- 
ing modes: 

4000 set user ID on execution 

20#0 set group ID on execution if # is 7, 5, 3, or 1 
enable mandatory locking if # is 6, 4, 2, or 

1000 sticky bit is turned on ((see chmod (2)) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

Symbolic changes are stated using letters that correspond both to access classes and 
to the individual permissions themselves. Permissions to a file may vary depending 
on your user identification number (UID) or group identification number (GID). Per- 
missions are described in three sequences each having three characters: 

User Group Other 

rwx rwx rwx 

This example (meaning that user, group, and others all have reading, writing, and 
execution permission to a given file) demonstrates two categories for granting per- 
missions: the access class and the permissions themselves. 

Thus, to change the mode of a file's (or directory's) permissions using chmod 's sym- 
bolic method, use the following syntax for mode: 

[ who ] operator [ permissions) ], ... 

A command line using the symbolic method would appear as follows: 

chmod g+rw file 

This command would make file readable and writable by the group. 

The who part can be stated as one or more of the following letters: 
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CHMOD (1) 



EXAMPLES 



u user s permissions 

g group's permissions 

others permissions 

The letter a (all) is equivalent to ugo and is the default if who is omitted. 

Operator can be + to add permission to the file's mode, - to take away permission, or = 
to assign permission absolutely. (Unlike other symbolic operations, = has an absolute 
effect in that it resets all other bits.) Omitting permission is only useful with = to take 
away all permissions. 

Permission is any compatible combination of the following letters: 

r reading permission 

w writing permission 

x execution permission 

s user or group set-ID is turned on 

t sticky bit is turned on 

1 mandatory locking will occur during access 

Multiple symbolic modes separated by commas may be given, though no spaces may 
intervene between these modes. Operations are performed in the order given. Mul- 
tiple symbolic letters following a single operator cause the corresponding operations 
to be performed simultaneously. The letter s is only meaningful with u or g, and t 
only works with u. 

Mandatory file and record locking (1) refers to a file's ability to have its reading or 
writing permissions locked while a program is accessing that file. It is not possible to 
permit group execution and enable a file to be locked on execution at the same time. 
In addition, it is not possible to turn on the set-group-ID and enable a file to be locked 
on execution at the same time. The following examples, 

chmod g+x,+l file 

chmod g+s,+l file 

are, therefore, illegal usages and will elicit error messages. 

Only the owner of a file or directory (or the super-user) may change a file's mode. 
Only the super-user may set the sticky bit. In order to turn on a file's set-group-ID, 
your own group ID must correspond to the file's, and group execution must be set. 

chmod a-x file 

chmod 444 file 

The first examples deny execution permission to all. The absolute (octal) example 
permits only reading permissions. 

chmod go+rw file 

chmod 606 file 
These examples make a file readable and writable by the group and others. 

chmod +1 file 
This causes a file to be locked during access. 

chmod =rwx,g+s file 

chmod 2777 file 
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These last two examples enable all to read, write, and execute the file; and they turn | 

on the set eroup-ID. V. 



on the set group-ID, 

SEE ALSO 

ls(l), chmod(2) 
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NAME 
SYNOPSIS 



CH0WN(1) 



DESCRIPTION 



FILES 



NOTES 



SEE ALSO 



chown, chgrp - change owner or group 

chown owner file ... 
chown owner directory ... 
chgrp group file ... 
chgrp group directory ... 

chown changes the owner of the files or directories to owner. The owner may be either 
a decimal user ID or a login name found in the password file. 

Chgrp changes the group ID of the files or directories to group. The group may be 
either a decimal group ID or a group name found in the group file. 

If either command is invoked by other than the super-user, the set-user-ID and set- 
group-ID bits of the file mode, 04000 and 02000 respectively, will be cleared. 
Only the owner of a file (or the super-user) may change the owner or group of that 
file. 

/etc/passwd 
/etc/group 

In a Remote File Sharing environment, you may not have the permissions that the 
output of the Is -1 command leads you to believe. For more information see the Sys- 
tem Administrator's Guide. 

chmod(l). chown(2), group(4), passwd(4). 
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SYNOPSIS 

DESCRIPTION 



jSystem Administration Utilities 



SEE ALSO 
BUGS 



CHROOT(TM) 



chroot - change root directory for a command 

/etc/chroot newroot command 

chroot causes the given command to be executed relative to the new root. The mean- 
ing of any initial slashes (/) in the path names is changed for the command and any 
of its child processes to newroot. Furthermore, upon execution, the initial working 
directory is newroot . 

Notice, however, that if you redirect the output of the command to a file: 

chroot newroot command >x 

will create the file x relative to the original root of the command, not the new one. 

The new root path name is always relative to the current root: even if a chroot is 
currently in effect, the newroot argument is relative to the current root of the running 
process. 

This command can be run only by the super-user. 
cd(l), chroot(2). 

One should exercise extreme caution when referencing device files in the new root 
file system. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



chsh - change default login shell 

chsh name [ shell ] 

chsh is identical with passwd -s and is used to change your login shell. If no shell is 
specified, the shell reverts to the default login shell, fbin/sh. Only the super-user may 
specify anything other than /bin/csh, /bin/oldcsh, or /usr/nexv/csh. For example, 

chsh paul /bin/csh 
csh(l), passwd(l), passwd(5) 
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NAME 

clear - clear terminal screen 

SYNOPSIS 

clear 

DESCRIPTION 

Clear clears your screen if this is possible. It looks in the environment for the termi- 
nal type and then in /usr/lib/terminfo to figure out how to clear the screen. 

FILES 

/usr/lib/terminfo terminal information data base 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
WARNINGS 



CLRI(1M) 



clri - clear i-node 

/etc/clri special i-number ... 

clri writes nulls on the 64 bytes at offset i-number from the start of the i-node list. 
This effectively eliminates the i-node at that address. Special is the device name on 
which a file system has been defined. After clri is executed, any blocks in the affected 
file will show up as "not accounted for" when/sdc(lM) is run against the file-system. 
The i-node may be allocated to a new file. 

Read and write permission is required on the specified special device. 

This command is used to remove a file which appears in no directory; that is, to get 
rid of a file which cannot be removed with the rm command. 

fs(4), fsck(lM), fsdb(lM), ncheck(lM), rm(l). 

If the file is open for writing, clri will not work. The file system containing the file 
should NOT be mounted. 

If clri is used on the i-node number of a file that does appear in a directory, it is 
imperative to remove the entry in the directory at once, since the i-node may be allo- 
cated to a new file. The old directory entry, if not removed, continues to point to the 
same file. This sounds like a link, but does not work like one. Removing the old 
entry destroys the new file. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



'CMP(L) 



cmp - compare two files 

cmp[-l][-s]filelfile2 

The two files are compared. (If filel is -, the standard input is used.) Under default 
options, cmp makes no comment if the files are the same; if they differ, it announces 
the byte and line number at which the difference occurred. If one file is an initial 
subsequence of the other, that fact is noted. 

Options: 

-1 Print the byte number (decimal) and the differing bytes (octal) for each differ- 



ence. 



-s 



Print nothing for differing files; return codes only. 



comm(l),diff(l). 

Exit code is returned for identical files, 1 for different files, and 2 for an inaccessible 
or missing argument. 



c 



c 



( 



66 



Stardent 1500/3000 



Directory and File Management Utilities 



COL(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



C0L(1) 



SEE ALSO 
NOTES 



BUGS 



col - filter reverse line-feeds 

col[-b][-f][-x][-p] 

col reads from the standard input and writes onto the standard output. It performs 
the line overlays implied by reverse line feeds (ASCII code ESC-7), and by forward 
and reverse half-line-feeds (ESC-9 and ESC-8). col is particularly useful for filtering 
multicolumn output made with the .rt command of nroff and output resulting from 
use of the fW(l) preprocessor. 

If the -b option is given, col assumes that the output device in use is not capable of 
backspacing. In this case, if two or more characters are to appear in the same place, 
only the last one read will be output. 

Although col accepts half-line motions in its input, it normally does not emit them on 
output. Instead, text that would appear between lines is moved to the next lower 
full-line boundary. This treatment can be suppressed by the -f (fine) option; in this 
case, the output from col may contain forward half-line-feeds (ESC-9), but will still 
never contain either kind of reverse line motion. 

Unless the -x option is given, col will convert white space to tabs on output wherever 
possible to shorten printing time. 

The ASCII control characters SO (\017) and SI (\016) are assumed by col to start and 
end text in an alternate character set. The character set to which each input character 
belongs is remembered, and on output SI and SO characters are generated as 
appropriate to ensure that each character is printed in the correct character set. 

On input, the only control characters accepted are space, backspace, tab, return, 
new-line, SI, SO, VT (\013), and ESC followed by 7, 8, or 9. The VT character is an 
alternate form of full reverse line-feed, included for compatibility with some earlier 
programs of this type. All other non-printing characters are ignored. 

Normally, col will ignore any escape sequences unknown to it that are found in its 
input; the -p option may be used to cause col to output these sequences as regular 
characters, subject to overprinting from reverse line motions. The use of this option 
is highly discouraged unless the user is fully aware of the textual position of the 
escape sequences. 

nroff(l),tbl(l). 

The input format accepted by col matches the output produced by nroff with either 
the -T37 or -Tip options. Use -T37 (and the -f option of col) if the ultimate disposi- 
tion of the output of col will be a device that can interpret half-line motions, and -Tip 
otherwise. 

Cannot back up more than 128 lines. 

Allows at most 800 characters, including backspaces, on a line. 

Local vertical motions that would result in backing up over the first line of the docu- 
ment are ignored. As a result, the first line must not have any superscripts. 
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C0LCRT(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



C0LCRT(1) 



colcrt - filter nroff output for CRT previewing 

colcrt [-][ -2] [file... ] 

Colcrt provides virtual half-line and reverse line feed sequences for terminals without 
such capability, and on which overstriking is destructive. Half-line characters and 
underlining (changed to dashing '-') are placed on new lines in between the normal 
output lines. 

The optional - suppresses all underlining. It is especially useful for previewing 
allboxed tables from tbl(l). 

The option -2 causes all half-lines to be printed, effectively double spacing the out- 
put. Normally, a minimal space output format is used which will suppress empty 
lines. The program never suppresses two consecutive empty lines, however. The -2 
option is useful for sending output to the line printer when the output contains 
superscripts and subscripts which would otherwise be invisible. 

A typical use of colcrt would be 

tblexum2.n I nroff -ms I colcrt- I more 

nroff/troffd), col(l), more(l), ul(l) 

Should fold underlines onto blanks even with the '-' option so that a true underline 
character would show; if we did this, however, colcrt wouldn't get rid of cu'd underlining 
completely. 

Can't back up more than 102 lines. 

General overstriking is lost; as a special case ' I ' overstruck with '-' or underline 
becomes V. 

Lines are trimmed to 132 characters. 

Some provision should be made for processing superscripts and subscripts in docu- 
ments which are already double-spaced. 



c 
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COMB(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



COMB(1) 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



comb - combine SCCS deltas 



comb files 



comb generates a shell procedure [see sh(l)] which, when run, will reconstruct the 
given SCCS files. The reconstructed files will, hopefully, be smaller than the original 
files. The arguments may be specified in any order, but all keyletter arguments 
apply to all named SCCS files. If a directory is named, comb behaves as though each 
file in the directory were specified as a named file, except that non-SCCS files (last 
component of the path name does not begin with s.) and unreadable files are silently 
ignored. If a name of - is given, the standard input is read; each line of the input is 
taken to be the name of an SCCS file to be processed; non-SCCS files and unreadable 
files are silently ignored. The generated shell procedure is written on the standard 
output. 

The keyletter arguments are as follows. Each is explained as though only one named 
file is to be processed, but the effects of any keyletter argument apply independently 
to each named file. 

-o For each get -e generated, this argument causes the reconstructed file to 

be accessed at the release of the delta to be created, otherwise the recon- 
structed file would be accessed at the most recent ancestor. Use of the -o 
keyletter may decrease the size of the reconstructed SCCS file. It may also 
alter the shape of the delta tree of the original file. 

-s This argument causes comb to generate a shell procedure which, when 

run, will produce a report giving, for each file: the file name, size (in 
blocks) after combining, original size (also in blocks), and percentage 
change computed by: 

100 * (original - combined) / original 
It is recommended that before any SCCS files are actually combined, one 
should use this option to determine exactly how much space is saved by 
the combining process. 

-pSID The SCCS ID entification string (SID) of the oldest delta to be preserved. 
All older deltas are discarded in the reconstructed file. 

-dist A list (see getiX) for the syntax of a list) of deltas to be preserved. All 

other deltas are discarded. 

If no keyletter arguments are specified, comb will preserve only leaf deltas and the 
minimal number of ancestors needed to preserve the tree. 

s.COMB The name of the reconstructed SCCS file, 

comb????? Temporary. 

admin(l), delta(l), get(l), help(l), prs(l), sh(l), sccsfile(4) 

Use help (I) for explanations. 

comb may rearrange the shape of the tree of deltas. It may not save any space; in fact, 
it is possible for the reconstructed file to actually be larger than the original. 
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COMM(1) COMM(1) 

NAME f 

comm - select or reject lines common to two sorted files V 



SYNOPSIS 
DESCRIPTION 



comm [ - [ 123 ] ] filel file2 



comm reads filel and filel, which should be ordered in ASCII collating sequence (see 
sortd)), and produces a three-column output: lines only in filel; lines only in file2) 
and lines in both files. The file name - means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 
prints only the lines common to the two files; comm -23 prints only lines in the first 
file but not in the second; comm -123 prints nothing. 

SEE ALSO 

cmp(l), diff(l), sort(l), uniq(l). 



( 
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COMPRESS (1) 



NAME 
SYNOPSIS 

DESCRIPTION 



DIAGNOSTICS 



compress, uncompress, zcat - compress and expand data 

compress [ -f ] [ -v ] [ -c ] [ -b bits ] [name ... ] 
uncompress [ -f ] [ -v ] [ -c ] [ name ... ] 
zcat [name... ] 

Compress reduces the size of the named files using adaptive Lempel-Ziv coding. 
Whenever possible, each file is replaced by one with the extension .Z, while keeping 
the same ownership modes, access and modification times. If no files are specified, 
the standard input is compressed to the standard output. Compressed files can be 
restored to their original form using uncompress or zcat. 

The -f option will force compression of name, even if it does not actually shrink or 
the corresponding name.Z file already exists. Except when run in the background 
under /bin/sh, if -f is not given the user is prompted as to whether an existing name.Z 
file should be overwritten. 

The -c ("cat") option makes compress/uncompress write to the standard output; no 
files are changed. The nondestructive behavior of zcat is identical to that of 
uncompress -c. 

Compress uses the modified Lempel-Ziv algorithm popularized in "A Technique for 
High Performance Data Compression", Terry A. Welch, IEEE Computer, vol. 17, no. 6 
(June 1984), pp. 8-19. Common substrings in the file are first replaced by 9-bit codes 
257 and up. When code 512 is reached, the algorithm switches to 10-bit codes and 
continues to use more bits until the limit specified by the -b flag is reached (default 
16). Bits must be between 9 and 16. The default can be changed in the source to 
allow compress to be run on a smaller machine. 

After the bits limit is attained, compress periodically checks the compression ratio. If 
it is increasing, compress continues to use the existing code dictionary. However, if 
the compression ratio decreases, compress discards the table of substrings and 
rebuilds it from scratch. This allows the algorithm to adapt to the next "block" of the 
file. 

Note that the -b flag is omitted for uncompress, since the bits parameter specified dur- 
ing compression is encoded within the output, along with a magic number to ensure 
that neither decompression of random data nor recompression of compressed data is 
attempted. 

The amount of compression obtained depends on the size of the input, the number of 
bits per code, and the distribution of common substrings. Typically, text such as 
source code or English is reduced by 50-60%. Compression is generally much better 
than that achieved by Huffman coding (as used in pack), or adaptive Huffman coding 
{compact), and takes less time to compute. 

The -v option causes the printing of the percentage reduction of each file. 

If an error occurs, exit status is 1, else if the last file was not compressed because it 
became larger, the status is 2; else the status is 0. 

Usage: compress [-fvc] [-b maxbits] [file ...] 

Invalid options were specified on the command line. 
Missing maxbits 

Maxbits must follow -b. 
file: not in compressed format 

The file specified to uncompress has not been compressed. 
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file: compressed with xx bits, can only handle yy bits f 

File was compressed by a program that could deal with more bits 

than the compress code on this machine. Recompress the file with 

smaller bits, 
file: already has .Z suffix — no change 

The file is assumed to be already compressed. Rename the file and 

try again. 
file: filename too long to tack on .Z 

The file cannot be compressed because its name is longer than 12 

characters. Rename and try again. This message does not occur on 

BSD systems. 
file already exists; do you wish to overwrite (y or n)? 

Respond "y" if you want the output file to be replaced; "n" if not. 
uncompress: corrupt input 

A SIGSEGV violation was detected which usually means that the 

input file is corrupted. 
Compression: xx.xx% 

Percentage of the input saved by compression. (Relevant only for 

-v.) 

— not a regular file: unchanged 

When the input file is not a regular file, (e.g. a directory), it is left 
unaltered. 

— has xx other links: unchanged 

The input file has links; it is left unchanged. See ln(\) for more 
information. 

— file unchanged 

No savings is achieved by compression. The input remains virgin. 



BUGS 



Although compressed files are compatible between machines with large memory, 
-bl2 should be used for file transfer to architectures with a small process data space 
(64KB or less, as exhibited by the DEC PDP series, the Intel 80286, etc.) 

compress should be more flexible about the existence of the '.Z' suffix. 



( 
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CP(1) 

NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
WARNINGS 

BUGS 



CP(1) 



cp, In, mv - copy, link or move files 

cp filel [ file2 ...] target 

In [ -f -s ] filel [ file2 ...] target 

mv[-f] filel [ file2 ...] target 

filel is copied (linked, moved) to target. Under no circumstance can filel and target 
be the same (take care when using sh(l) metacharacters). If target is a directory, then 
one or more files are copied (linked, moved) to that directory. If target is a file, its 
contents are destroyed. 

If mv or In determines that the mode of target forbids writing, it will print the mode 
(see chmod(2)), ask for a response, and read the standard input for one line; if the line 
begins with y, the mv or In occurs, if permissable; if not, the command exits. When 
the -f option is used or if the standard input is not a terminal, no questions are asked 
and the mv or In is done. 

The -s option causes In to create symbolic links. You may not create a symbolic link 
to a target file if the file already exists. There are no checks on the existence of the 
source of the symbolic link. 

A symbolic link contains the name of the file to which it is linked. The referenced file 
is used when an open(2) operation is performed on the link. A stat(2) on a symbolic 
link will return the linked-to file; an lstat(2) must be done to obtain information 
about the link. The readlink(2) call may be used to read the contents of a symbolic 
link. Symbolic links may span file systems and may refer to directories. 

Only mv will allow filel to be a directory, in which case the directory rename will 
occur only if the two directories have the same parent; filel is renamed target. If filel 
is a file and target is a link to another file with links, the other links remain and target 
becomes a new file. 

When using cp, if target is not a file, a new file is created which has the same mode as 
filel except that the sticky bit is not set unless you are super-user; the owner and 
group of target are those of the user. If target is a file, copying a file into target does 
not change its mode, owner, nor group. The last modification time of target (and last 
access time, if target did not exist) and the last access time of filel are set to the time 
the copy was made. If target is a link to a file, all links remain and the file is changed. 

chmod(l), cpio(l), rm(l). 

In will not create hard links across file systems. This restriction is necessary because 
file systems can be added and removed. 

If filel and target lie on different file systems, mv must copy the file and delete the 
original. In this case any linking relationship with other files is lost. 
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NAME 






cp - copy 


SYNOPSIS 






cp [ -ip ] filel ffle2 




cp [ -ipr ] file ... directory 


DESCRIPTION 





SEE ALSO 



CP(1B) 



C 



filel is copied onto file2 . By default, the mode and owner of filel are preserved if it 
already existed; otherwise the mode of the source file modified by the current 
umask{2) is used. The -p option causes cp to attempt to preserve (duplicate) in its 
copies the modification times and modes of the source files, ignoring the present 

umask. 

In the second form, one or more files are copied into the directory with their original 
file-names. 

cp refuses to copy a file onto itself. 

If the -i option is specified, cp will prompt the user with the name of the file when- 
ever the copy will cause an old file to be overwritten. An answer of 'y' will cause cp 
to continue. Any other answer will prevent it from overwriting the file. 

If the -r option is specified and any of the source files are directories, cp copies each 
subtree rooted at that name; in this case the destination must be a directory. 

cat(l),mv(l),rcp(lC) 



c 



c 
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CPI0(1) 

NAME 
SYNOPSIS 



DESCRIPTION 



CPI0(1) 



cpio - copy file archives in and out 

cpio -o[acBv] 

cpio -i[Bcdmrtuvf sSb6] [ patterns ] 

cpio -p[adlmuv] directory 

cpio -o (copy out) reads the standard input to obtain a list of path names and copies 
those files onto the standard output together with path name and status information. 
Output is padded to a 512-byte boundary. 

cpio -i (copy in) extracts files from the standard input, which is assumed to be the 
product of a previous cpio -o. Only files with names that match patterns are selected. 
Patterns are regular expressions given in the name-generating notation of sh(l). In 
patterns, meta-characters ?, *, and [ . . .] match the slash / character. Multiple patterns 
may be specified and if no patterns are specified, the default for patterns is * (i.e., 
select all files). Each pattern should be surrounded by double quotes. The extracted 
files are conditionally created and copied into the current directory tree based upon 
the options described below. The permissions of the files will be those of the previ- 
ous cpio -o. The owner and group of the files will be that of the current user unless 
the user is super-user, which causes cpio to retain the owner and group of the files of 
the previous cpio -o. NOTE: If cpio -i tries to create a file that already exists and the 
existing file is the same age or newer, cpio will output a warning message and not 
replace the file. (The -u option can be used to unconditionally overwrite the existing 
file.) 

cpio -p (pass) reads the standard input to obtain a list of path names of files that are 
conditionally created and copied into the destination directory tree based upon the 
options described below. 



The meanings of the available options are 



B 



d 
c 



m 



Reset access times of input files after they have been copied. Access times are 

not reset for linked files when cpio -pla is specified. 

Input/output is to be blocked 5,120 bytes to the record (does not apply to the 

pass option; meaningful only with data directed to or from a character special 

device, e.g. /dev/rmt/0m. 

Directories are to be created as needed. 

Write header information in ASCII character form for portability. Always use 

this option when origin and destination machines are different types. 

Interactively rename files. If the user types a null line, the file is skipped. (Not 

available with cpio -p.) 

Print a table of contents of the input. No files are created. 

Copy unconditionally (normally, an older file will not replace a newer file with 

the same name). 

Verbose: causes a list of file names to be printed. When used with the t option, 

the table of contents looks like the output of an Is -1 command (see Zs(D). 

Whenever possible, link files rather than copying them. Usable only with the 

-p option. 

Retain previous file modification time. This option is ineffective on directories 

that are being copied. 

Copy in all files except those in patterns. 

Swap bytes within each half word. Use only with the -i option. 



Stardent 1500/3000 



75 



Essential Utilities 



CPI0(1) 



CP10(1) 



EXAMPLES 



SEE ALSO 
NOTES 



5 Swap halfwords within each word. Use only with the -i option. 

b Reverses the order of the bytes within each word. Use only with the -i option. 

6 Process an old (i.e. UNIX System Sixth Edition format) file. Only useful with -i 
(copy in). 

NOTE: cpio assumes four-byte words. 

If cpio reaches end of medium (end of a diskette for example), when writing to (-o) 
or reading from (-i) a character special device, cpio will print the message: 

If you want to go on, type device! file name when ready. 

To continue, you must replace the medium and type the character special device 
name (/dev/rtape/c0d6h for example) and carriage return. You may want to continue 
by directing cpio to use a different device. For example, if you have two floppy 
drives you may want to switch between them so cpio can proceed while you are 
changing the floppies. (A carriage return alone causes the cpio process to exit.) 

The following examples show three uses of cpio. 

When standard input is directed through a pipe to cpio -o, it groups the files so they 
can be directed (>) to a single file (../newfile). Instead of "Is," you could use find, 
echo, cat, etc. to pipe a list of names to cpio. You could direct the output to a device 
instead of a file. 

Is I cpio -o >Jnewfile 

cpio -i uses the output file of cpio -o (directed through a pipe with cat in the exam- 
ple), takes out those files that match the patterns (memo/al, memo/b*), creates 
directories below the current directory as needed (-d option), and places the files in 
the appropriate directories. If no patterns were given, all files from "newfile" would 
be placed in the directory . 

cat newfile I cpio -id "memo/al" "memo/b*" 

cpio -p takes the file names piped to it and copies or links (-1 option) those files to 
another directory on your machine (newdir in the example). The -d options says to 
create directories as needed. The -m option says retain the modification time. (It is 
important to use the -depth option of find to generate path names for cpio. This 
eliminates problems cpio could have trying to create files under read-only direc- 
tories.) 

find . -depth -print I cpio -pdlmv newdir 
ar(l), find(l), ls(l), tar(l), cpio(4). 

1) Path names are restricted to 256 characters. 

2) Only the super-user can copy special files. 

3) Blocks are reported in 512-byte quantities. 
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CPP(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



CPP(1) 



cpp - the C language preprocessor 

lib/cpp [ option ... ] [ ifile [ ofile ] ] 

The C language preprocessor, cpp , is invoked as the first pass of any C compilation 
by the cc(l) command. Thus cpp's output is designed to be in a form acceptable as 
input to the next pass of the C compiler. As the C language evolves, cpp and the rest 
of the C compilation package will be modified to follow these changes. Therefore, 
the use of cpp other than through the cc(l) command is not suggested, since the func- 
tionality of cpp may someday be moved elsewhere. See m4(l) for a general macro 
processor. 

cpp optionally accepts two file names as arguments. Ifile and ofile are respectively the 
input and output for the preprocessor. They default to standard input and standard 
output if not supplied. 

The following options to cpp are recognized: 

-P Preprocess the input without producing the line control information used by 
the next pass of the C compiler. 

-C By default, cpp strips C-style comments. If the -C option is specified, all com- 
ments (except those found on cpp directive lines) are passed along. 

-Unatne 

Remove any initial definition of name, where name is a reserved symbol that is 
predefined by the particular preprocessor. Following is the current list of these 
reserved symbols: 

operating system: unix 

hardware: mips 

manufacturer: ardent 

language: LANGUAGE _C for C 

-Dname 
-Dname=def 

Define name with value def as if by a #define. If no =def is given, name is 

defined with value 1. The -D option has lower precedence than the -U option. 

That is, if the same name is used in both a -U option and a -D option, the name 

will be undefined regardless of the order of the options. 

-I Do not search the standard places for #include files. 

-Idir Change the algorithm for searching for #include files whose names do not 
begin with / to look in dir before looking in the directories on the standard list. 
Thus, #include files whose names are enclosed in M " will be searched for first in 
the directory of the file with the #include line, then in directories named in -I 
options, and last in directories on a standard list. For #include files whose 
names are enclosed in <>, the directory of the file with the #include line is not 
searched. 

-H 



-l 



Print, one per line on standard error, the path names of included files. 

Compute a #ident control line for the input file and every included file giving a 
cyclic redundancy checksum for the file contents. 

Two special names are understood by cpp. The name LINE is defined as the 

current line number (as a decimal integer) as known by cpp, and FILE. is defined 

as the current file name (as a C string) as known by cpp. They can be used anywhere 
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(including in macros) just as any other defined name. £ 

All cpp directive lines start with # in column 1. Any number of blanks and tabs is 
allowed between the # and the directive. The directives are: 

#define name token-string 

Replace subsequent instances of name with tokens t ring. 

#define namei arg, ..., org ) token-string 

Notice that there can be no space between name and the (. Replace subsequent 
instances of name followed by a (, a list of comma-separated sets of tokens, and 
a ) followed by token-string, where each occurrence of an arg in the token-string 
is replaced by the corresponding set of tokens in the comma-separated list. 
When a macro with arguments is expanded, the arguments are placed into the 
expanded token-string unchanged. After the entire token-string has been 
expanded, cpp re-starts its scan for names to expand at the beginning of the 
newly created token-string. 

#undef name 

Cause the definition of name (if any) to be forgotten from now on. No addi- 
tional tokens are permitted on the directive line after name. 

#ident "string" 

Put string into the .comment section of an object file. 

#include "filename" 

#include <filename> 

Include at this point the contents of filename (which will then be run through 
cpp). When the <filename> notation is used, filename is only searched for in the 
standard places. See the -I and -Y options above for more detail. No addi- 
tional tokens are permitted on the directive line after the final " or >. 

#line integer-constant "filename" 

Causes cpp to generate line control information for the next pass of the C com- 
piler. Integer-constant is the line number of the next line and filename is the file 
from which it comes. If "filename" is not given, the current file name is 
unchanged. No additional tokens are permitted on the directive line after the 
optional filename. 

#endif 

Ends a section of lines begun by a test directive (#if, #ifdef, or #ifndef). Each 
test directive must have a matching #endif . No additional tokens are permit- 
ted on the directive line. 

#if def name 

The lines following will appear in the output if and only if name has been the 
subject of a previous #define without being the subject of an intervening 
#undef . No additional tokens are permitted on the directive line after name . 

#ifndef name 

The lines following will appear in the output if and only if name has not been 
the subject of a previous # define. No additional tokens are permitted on the 
directive line after name . 

#if constant-expression 

Lines following will appear in the output if and only if the constant-expression 
evaluates to non-zero. All binary non-assignment C operators, the ?: operator, 
the unary -, !, and ~ operators are all legal in constant-expression. The pre- 
cedence of the operators is the same as defined by the C language. There is also 
a unary operator defined, which can be used in constant-expression in these two 
forms: defined ( name ) or defined name. This allows the utility of #ifdef and 
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CPP(T) 



CPP(1) 



FILES 

SEE ALSO 
DIAGNOSTICS 

NOTES 



#ifndef in a #if directive. Only these operators, integer constants, and names 
which are known by cpp should be used in constant-expression. In particular, the 
sizeof operator is not available. 

To test whether either of two symbols, foo and fum , are defined, use 

#if defined(foo) I I defined(fum) 

#elif constant-expression 

An arbitrary number of #elif directives is allowed between a #if, #ifdef, or 
#ifndef directive and a #else or #endif directive. The lines following the #elif 
directive will appear in the output if and only if the preceding test directive 
evaluates to zero, all intervening #elif directives evaluate to zero, and the 
constant-expression evaluates to non-zero. If constant-expression evaluates to 
non-zero, all succeeding #elif and #else directives will be ignored. Any 
constant-expression allowed in a #if directive is allowed in a #elif directive. 

#else 

The lines following will appear in the output if and only if the preceding test 
directive evaluates to zero, and all intervening #elif directives evaluate to zero. 
No additional tokens are permitted on the directive line. 

The test directives and the possible #else directives can be nested. 

#pragma 

name The name specifies a compiler optimization that is to be overridden. 
Additional details appear in the Programmer's Guide . 



INCDIR 



LIBDIR 



standard directory list for #include files, usually 
/usr/include 

usually /lib 



cc(l),lint(l),m4(l). 

The error messages produced by cpp are intended to be self-explanatory. The line 
number and file name where the error occurred are printed along with the diagnos- 
tic. 

Because the standard directory for included files may be different in different 
environments, this form of #include directive: 

#include <file.h> 
should be used, rather than one with an absolute path, like: 

#include n /usr/include/f ile .h" 
cpp warns about the use of the absolute pathname. 
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SYNOPSIS 

DESCRIPTION 



Cross Generation 



SEE ALSO 



CPSET(1M) 



cpset - install object files in binary directories 

cpset [-o] object directory [mode owner group] 

cpset is used to install the specified object file in the given directory. The mode, owner, 
and group of the destination file may be specified on the command line. If this data is 
omitted, two results are possible: 

If the user of cpset has administrative permissions (that is, the 

user's numberical ID is less than 100), the following defaults are pro- 

vided: 

mode -0755 

owner - bin 

group - bin 

If the user is not an administrator, the default, owner, and group of the 
destination file will be that of the invoker. 

An optional argument of -o will force cpset to move object to OLDobject in the destina- 
tion directory before installing the new object. For example: 

cpset echo /bin 0755 bin bin 

cpset echo /bin 

cpset echo /bin/ echo 

All the examples above have the same effect (assuming the user is an administrator). 
The file echo will be copied into /bin and will be given 0755, bin, bin as the mode, 
owner and group, respectively. 

cpset ustilizes the file /usr/src/destinations to determine the final destination of a file. 
The locations file contains pairs of path names separated by spaces or tabls. The first 
name is the "official" destination (for example: /bin/echo). The second name is the 
new destination. For example, if echo is moved from /bin to /usr/bin, the entry in 
/usr/src/destinations would be: 

/bin/echo /usr /bin/echo 

When the actual installation happens, cpset verifies that the "old" path name does 
not exist. If a file exists at that location, cpset issues a warning and continues. This 
file does not exist on a distribution tape; it us used by sites to track local command 
movement. The procedures used to build the source will be responsible for defining 
the "official" locations of the source. 

The environment variable ROOT will be used to locate the destination file (in the 
form $ROOT/usr/src/destination). This is necessary in the cases where cross genera- 
tion is being done on a production system. 

install(lM), make(l), mk(8) 
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NAME 

SYNOPSIS 

DESCRIPTION 



CRASH (1M) 



crash - examine system images 

/etc/crash [ -d dumpfile ] [ -n namelist ] [ -w outputfile ] [-m] 

The crash command is used to examine the system memory image of a live or a 
crashed system by formatting and printing control structures, tables, and other infor- 
mation. Command line arguments to crash are dumpfile, namelist, and outputfile. 

Dumpfile is the file containing the system memory image. The default dumpfile is 
/dev/mem. The system image can also be a regular file or disk partition of dump pro- 
duced by the boot PROM sysdump command. 

The text file namelist contains the symbol table information needed for symbolic 
access to the system memory image to be examined. The default namelist is junix. If a 
system image from another machine is to be examined, the corresponding text file 
must be copied from that machine. 

When the crash command is invoked, a session is initiated. The output from a crash 
session is directed to outputfile. The default outputfile is the standard output. 

Input during a crash session is of the form: 

function [argument ... ] 

where function is one of the crash functions described in the "FUNCTIONS" section of 
this manual page, and arguments are qualifying data that indicate which items of the 
system image are to be printed. 

The default for process-related items is the process for both running systems and 
crashed systems. If the contents of a table are being dumped, the default is all active 
table entries. 

The -m option is meant for running systems only. It opens the dump file with write 
permission so that use of the crash function modify will be allowed. 

The following function options are available to crash functions wherever they are 
semantically valid. 

-e Display every entry in a table. 

-f Display the full structure. 

-s process 

Specify a process slot other than the default. 

-v Interpret all address arguments in the command line as virtual addresses. 

-w file 

Redirect the output of a function to file. 

The functions defproc and redirect correspond to the function options -s and -w. def- 
proc sets the value of the process slot argument for subsequent functions; and redirect 
redirects all subsequent output. 

Output from crash functions may be piped to another program in the following way: 

function [ argument ... ] ! shell_command 
For example, 

mount ! grep rw 
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FUNCTIONS 



will write all mount table entries with an rw flag to the standard output. The redirec- 
tion option <-w) cannot be used with this feature. 

Depending on the context of the function, numeric arguments will be assumed to be 
in a specific radix. Counts are assumed to be decimal. Addresses are always hexade- 
cimal. Table address arguments larger than the size of the function table will be 
interpreted as hexadecimal addresses; those smaller will be assumed to be decimal 
slots in the table. Default bases on all arguments may be overridden. The C conven- 
tions for designating the bases of numbers are recognized. A number that is usually 
interpreted as decimal will be interpreted as hexadecimal if it is preceded by Ox and 
as octal if it is preceded by 0. Decimal override is designated by Od, and binary by Ob. 

Aliases for functions may be any uniquely identifiable initial substring of the func- 
tion name. Traditional aliases of one letter, such as p for proc, remain valid. 

Many functions accept different forms of entry for the same argument. Requests for 
table information will accept a table entry number, a physical address, a virtual 
address, a symbol, a range, or an expression. A range of slot numbers may be 
specified in the form a-b where a and b are decimal numbers. An expression consists 
of two operands and an operator. An operand may be an address, a symbol, or a 
number; the operator may be +, -, *, /, &, or I . An operand which is a number 
should be preceded by a radix prefix if it is not a decimal number (0 for octal, Ox for 
hexidecimal, Ob for binary). The expression must be enclosed in parentheses (). 
Other functions will accept any of these argument forms that are meaningful. 

Two abbreviated arguments to crash functions are used throughout. Both accept data 
entered in several forms. They may be expanded into the following: 

table__entry = table entry I address I symbol I range I expression 

start_addr = address I symbol I expression 

? [ -w file ] List available functions. 

!cmd 

Escape to the shell to execute a command. 

adv [ -e ] 

[ -w file ] [ table entry ] Print the advertise table. 

base [ -w file ] number ... 

Print number in binary, octal, decimal, and hexadecimal. A number in a radix 
other then decimal should be preceded by a prefix that indicates its radix as fol- 
lows: Ox, hexidecimal; 0, octal; and Ob, binary. 

buffer [ -w file] [ -format ] buf f erslot 

or 

buffer [-w file] [-format] []start_addr 
Alias: b. 

Print the contents of a buffer in the designated format. The following format 
designations are recognized: -b, byte: -c, character; -d, decimal; -x, hexade- 
cimal; -o, octal; -r, directory; and -i, inode. If no format is given, the previous 
format is used. The default format at the beginning of a crash session is hexade- 
cimal. 

bufhdr[-f] [-wfile] [[] table_entry...] 
Alias: buf. 
Print system buffer headers. 
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help [ -w file ] function ... 

Print a description of the named function, including syntax and aliases. 

inode[-e] [-f] [-wfile] [ table_entry ... ] 
Alias: i. 
Print the inode table, including file system switch information. 

Ick [ -e ] [ -w file ] [ table_entry ... ] 
Alias: 1. 

Print record locking information. If the -e option is used or table address argu- 
ments are given, the record lock list is printed. If no argument is entered, infor- 
mation on locks relative to inodes is printed. 

linkblk[-e] [-wfile] [table_entry...] 
Print the linkblk table. 

map [-w file] mapname ... 

Print the map structure of the given mapname. 

mbfree [-wfile] 

Print free streams message block headers. 

mblock[-e] [-c] [-n] [-p] [-w filename] [table_entry ...] 

Print allocated streams message block headers. If the -e option is used, all mes- 
sage headers (including those on the free list) are printed. The -c option causes 
the printing to traverse the continuation pointer. Similarly, the -n option for 
the next block pointer and -p for the previous block pointer. 

modify 

[ -w file] [ -mode ] [ -s process] [ -v ] start_addr Prints the current contents of 
the location given by start jiddr in one of three modes: long ( -1 ), short ( -t ), or 
byte ( -b ). It then accepts input, allowing the value to be changed. A carriage 
return means no change. A dot ( . ), or the letter q ( q or Q) stops the command. 
This is an extremely dangerous command to use on running systems and you 
should exercise great care in its use. ..F- 

mount [-e] [-wfile] [table_entry...] 
Alias: m. 
Print the mount table. 

nm [-w file] symbol ... 

Print value and type for the given symbol. 

nvram [ -w file ] 

Print all the non-volatile RAM variables. 

od [ -v ] [ -w file ] [ -format ] [ -mode ] [ -s process ] start_addr [ count ] 
Aliases: rd, d 

Print count values starting at the start address in one of the following formats: 
character (-c), decimal (-d), hexadecimal (-x), octal (-o), ascii (-a), or 
hexadecimal/character (-h), and one of the following modes: long (-1), short 
(-t), or byte (-b). The default mode for character and ascii formats is byte; the 
default mode for decimal, hexadecimal, and octal formats is long. The format 
-h prints both hexadecimal and character representations of the addresses 
dumped; no mode needs to be specified. When format or mode is omitted, the 
previous value is used. At the start of a crash session, the format is hexadecimal 
and the mode is long. If no count is entered, 1 is assumed. 

pcb [ -w file ] [ -i start_addr ] 

Print the process control block for the current process. 
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pdt [ -e ] [ -w file ] [ -s process ] section segment 

or 

pdt [-w file] start_addr [count] 

The page descriptor table starting at the start address for count entries is 
printed. If no count is entered, 1 is assumed. 

pfdat[-e] [-f] [-wfile] [table_entry ...] 
Print the pfdata table. 

proc [-f ] [ -w file ] [ [ -p ] table_entry ... #procid ... ] 

or 

proc[-f] [-wfile] [-r] 
Alias: p. 

Print the process table. Process table information may be specified in two ways. 
First, any mixture of table entries and process ids may be entered. Each process 
id must be preceded by a #. Alternatively, process table information for runn- 
able processes may be specified with the runnable option (-r). 

putbuf 

[ -w file ] Display the contents of the console logging buffer. All console mes- 
sages produced by the kernel are logged to the console. 

qrun [-wfile] 

Print the list of scheduled streams queues. 

queue [ -e ] [ -w file ] [ table_entry ... ] 
Print streams queues. 

quit Alias: q. 

Terminate the crash session. 

r [-wfile] [-f] [-e] [-i] [-m] [-g] 

Print CPU registers as stored at the |ime of a panic, -i prints I/O board regis- 
ters, -m prints memory board registers, and -g prints graphics board registers. 

rcvd [ -e ] [ -f ] [ -w file ] [ table_entry . .. ] 
Print the receive descriptor table. 

redirect [ -w file ] [ -c ] 

or 

redirect [ -w file ] [ file ] 

Used with a file name, redirects output of a crash session to the named file. If 
no argument is given, the file name to which output is being redirected is 
printed. Alternatively, the close option (-c) closes the previously set file and 
redirects output to the standard output. 

region [-e ] [ -f ] [ -w file ] [ table_entry . . . ] 
Print the region table. 

search [ -w file ] [ -m mask ] [ -s process ] pattern start_addr length 

Print the words in memory that match pattern, beginning at the start address 
for length words. The mask is anded (&) with each memory word and the 
result compared against the pattern. The mask defaults to Oxffffffff . 

semaphore 

[ -w file ] start_addr Print the semaphore data structure for designated sema- 
phores. 
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pdt [ -e ] [ -w file ] [ -s process ] section segment 

or 

pdt [-w file] start_addr [count] 

The page descriptor table starting at the start address for count entries is 
printed. If no count is entered, 1 is assumed. 

pfdat[-e] [-f] [-wfile] [table_entry ...] 
Print the pfdata table. 

proc [-f ] [ -w file ] [ [ -p ] table_entry ... #procid ... ] 

or 

proc[-f] [-wfile] [-r] 
Alias: p. 

Print the process table. Process table information may be specified in two ways. 
First, any mixture of table entries and process ids may be entered. Each process 
id must be preceded by a #. Alternatively, process table information for runn- 
able processes may be specified with the runnable option (-r). 

putbuf 

[ -w file ] Display the contents of the console logging buffer. All console mes- 
sages produced by the kernel are logged to the console. 

qrun [-wfile] 

Print the list of scheduled streams queues. 

queue [ -e ] [ -w file ] [ table_entry ... ] 
Print streams queues. 

quit Alias: q. 

Terminate the crash session. 

r [-wfile] [-f] [-e] [-i] [-m] [-g] 

Print CPU registers as stored at the time of a panic, -i prints I/O board regis- 
ters, -m prints memory board registers, and -g prints graphics board registers. 

rcvd [ -e ] [ -f ] [ -w file ] [ table_entry . .. ] 
Print the receive descriptor table. 

redirect [-wfile] [-c] 

or 

redirect [-wfile] [file] 

Used with a file name, redirects output of a crash session to the named file. If 
no argument is given, the file name to which output is being redirected is 
printed. Alternatively, the close option (-c) closes the previously set file and 
redirects output to the standard output. 

region [-e] [-f] [-wfile] [table_entry...] 
Print the region table. 

search [ -w file ] [ -m mask ] [ -s process ] pattern start_addr length 

Print the words in memory that match pattern, beginning at the start address 
for length words. The mask is anded (&) with each memory word and the 
result compared against the pattern. The mask defaults to Oxffffffff . 

semaphore 

[ -w file ] start_addr Print the semaphore data structure for designated sema- 
phores. 



Stardent 1500/3000 85 



System Administration Utilities 



FILES 



( 



CRASH <1M) CRASH (1M) 

size [ -w file ] [ -x ] [ structure_name ... ] 

Print the size of the designated structure. The (-x) option prints the size in hex- 
adecimal. If no argument is given, a list of the structure names for which sizes 
are available is printed. 

slog [ -w file ] Print the semaphore activity log. 

sndd [ -e ] [ -w file ] [ table_entry .. . ] 
Print the send descriptor table. 

srmount[-e] [-wfile] [table_entry ...] 
Print the server mount table. 

stack [-wfile] [-b] [-s process] [pcsp] 
Alias: s. 

Print a stack traceback of pc and sp values for the designated process. Default 
is the currently set defproc process. This command uses the pc and sp values 
from the pcb in the user area to start the traceback. These values are incorrect 
for processes that are active. Specify pc and sp values for stack traceback of 
active processes. The -b option attempts to do a reverse stack traceback start- 
ing from the first exception frame. 

stat [-wfile] 

Print system statistics. 

stream [ -e ] [ -f ] [ -w file ] [ table_entry ... ] 
Print the streams table. 

strstat [ -w file ] 

Print streams statistics. 

ts [-w file] virtual_address ... I 

Print closest text symbol to the designated address. 

tty[-e] [-f] [-wfile] [-ttype[table_entry...]] 

or 

tty[-e] [-f] [-wfile] [[-p]start_addr] 
Valid types: pp, iu. 

Print the tty table. If no arguments are given, the tty table for both tty types is 
printed. If the -t option is used, the table for the single tty type specified is 
printed. If no argument follows the type option, all entries in the table are 
printed. A single tty entry may be specified from the start address. 

user[-f] [-wfile] [process] 
Alias: u. 
Print the ublock for the designated process. 

var [ -w file ] 
Alias: v. 
Print the tunable system parameters. 

vtop [ -w file ] [ -s process ] start_addr ... 

Print the physical address translation of the virtual start address. 



/dev/mem system image of currently running system 



C 
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SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
DIAGNOSTICS 



cron - clock daemon 

/etc/cron 

cron executes commands at specified dates and times. Regularly scheduled com- 
mands can be specified according to instructions found in crontab files in the direc- 
tory /usr/spool/cron/crontabs. Users can submit their own crontab file via the cron- 
tab (1) command. Commands which are to be executed only once may be submitted 
via the at{\) command. 

cron only examines crontab files and at command files during process initialization 
and when a file changes via crontab or at. This reduces the overhead of checking for 
new or changed files at regularly scheduled intervals. 

Since cron never exits, it should be executed only once. This is done routinely 
through /etc/rc2.d/S75cron at system boot time. /usr/lib/cron/FIFO is used as a lock 
file to prevent the execution of more than one cron. 

/usr/lib/cron main cron directory 

/usr/lib/cron/FIFO 

used as a lock file 
/usr/lib/cron/log accounting information 
/usr/spool/cron spool area 

at(l), crontab(l), sh(l), queuedefs(4) 

A history of all actions taken by cron are recorded in /usr/lib/cron/log. 
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FILES 
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crontab - user crontab file 

crontab [file] 
crontab -r 
crontab -1 

crontab copies the specified file, or standard input if no file is specified, into a direc- 
tory that holds all users' crontabs. The -r option removes a user's crontab from the 
crontab directory, crontab -1 will list the crontab file for the invoking user. 

Users are permitted to use crontab if their names appear in the file 
/usr/lib/cron/cron.allow. If that file does not exist, the file /usr/lib/cron/cron,deny is 
checked to determine if the user should be denied access to crontab. It neither file 
exists, only root is allowed to submit a job. If cron.allow does not exist and 
cron.deny exists but is empty, global usage is permitted. The allow/deny files con- 
sist of one user name per line. 

A crontab file consists of lines of six fields each. The fields are separated by spaces or 
tabs. The first five are integer patterns that specify the following: 

minute (0-59), 

hour (0-23), 

day of the month (1-31), 

month of the year (1-12), 

day of the week (0-6 with 0=Sunday). 

Each of these patterns may be either an asterisk (meaning all legal values) or a list of 
elements separated by commas. An element is either a number or two numbers 
separated by a minus sign (meaning an inclusive range). Note that the specification 
of days may be made by two fields (day of the month and day of the week). If both 
are specified as a list of elements, both are adhered to. For example, 1,15 * 1 
would run a command on the first and fifteenth of each month, as well as on every 
Monday. To specify days by only one field, the other field should be set to * (for 
example, 0**1 would run a command only on Mondays). 

The sixth field of a line in a crontab file is a string that is executed by the shell at the 
specified times. A percent character in this field (unless escaped by \) is translated to 
a new-line character. Only the first line (up to a % or end of line) of the command 
field is executed by the shell. The other lines are made available to the command as 
standard input. 

The shell is invoked from your $HOME directory with an argO of sh. Users who 
desire to have their .profile executed must explicitly do so in the crontab file. Cron 
supplies a default environment for every shell, defining HOME, LOGNAME, 
SHELL(=/bin/sh), and PATH(=:/bin:/usr/bin:/usr/lbin). 

If you do not redirect the standard output and standard error of your commands, 
any generated output or errors will be mailed to you. 



/usr/lib/cron 

/usr/spool/cron/crontabs 

/usr/lib/cron/log 

/usr/lib/cron/cron.allow 

/usr/lib/cron/cron.deny 



main cron directory 
spool area 

accounting information 
list of allowed users 
list of denied users 
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SEE ALSO 

sh(l), cron(lM), queuedefs(4) 

WARNINGS 

If you inadvertently enter the crontab command with no argument(s), do not attempt 
to get out with a CTRL-d. This will cause all entries in your crontab file to be 
removed. Instead, exit with a DEL. 
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SEE ALSO 
WARNING 



BUGS 



CRYPTO) 



crypt - encode/decode 

crypt [ password ] 
crypt [-k] 

crypt reads from the standard input and writes on the standard output. The password 
is a key that selects a particular transformation. If no argument is given, crypt 
demands a key from the terminal and turns off printing while the key is being typed 
in. If the -k option is used, crypt will use the key assigned to the environment vari- 
able CRYPTKEY. crypt encrypts and decrypts with the same key: 

crypt key <clear >cypher 
crypt key <cypher 1 pr 

Files encrypted by crypt are compatible with those treated by the editors ed(l), 
edit{\), ex{l), and vi{\) in encryption mode. 

The security of encrypted files depends on three factors: the fundamental method 
must be hard to solve; direct search of the key space must be infeasible; "sneak 
paths" by which keys or clear text can become visible must be minimized. 

crypt implements a one-rotor machine designed along the lines of the German 
Enigma, but with a 256-element rotor. Methods of attack on such machines are 
known, but not widely; moreover the amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately 
designed to be expensive, i.e., to take a substantial fraction of a second to compute. 
However, if keys are restricted to (say) three lower-case letters, then encrypted files 
can be read by expending only a substantial fraction of five minutes of machine time. 

If the key is an argument to the crypt command, it is potentially visible to users exe- 
cuting ps(l) or a derivative. The choice of keys and key security are the most vulner- 
able aspect of crypt. 



/dev/tty 



for typed key 



ed(l), edit(l), ex(l), makekey(l), ps(l), stty(l), vi(l). 

This command is provided with the Security Administration Utilities, which is only 
available in the United States. If two or more files encrypted with the same key are 
concatenated and an attempt is made to decrypt the result, only the contents of the 
first of the original files will be decrypted correctly. 

If output is piped to nroff and the encryption key is not given on the command line, 
crypt can leave terminal modes in a strange state (see stty{\)). 
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csh - a shell (command interpreter) with C-like syntax 

csh [ -cefinstvVxX ] [ arg ... ] 

Csh is a first implementation of a command language interpreter incorporating a his- 
tory mechanism (see History Substitutions), job control facilities (see Jobs), interac- 
tive file name and user name completion (see File Name Completion), and a C-like 
syntax. So as to be able to use its job control facilities, users of csh must (and 
automatically) use the new tty driver fully described in %(4). This new tty driver 
allows generation of interrupt characters from the keyboard to tell jobs to stop. See 
sfty (IB) for details on setting options in the new tty driver. 

An instance of csh begins by executing commands from the file '.cshrc' in the home 
directory of the invoker. If this is a login shell then it also executes commands from 
the file '.login' there. It is typical for users on crt's to put the command "stty crt" in 
their .login file, and to also invoke tsetiX) there. 

In the normal case, the shell will then begin reading commands from the terminal, 
prompting with '% '. Processing of arguments and the use of the shell to process files 
containing command scripts will be described later. 

The shell then repeatedly performs the following actions: a line of command input is 
read and broken into words . This sequence of words is placed on the command his- 
tory list and then parsed. Finally each command in the current line is executed. 

When a login shell terminates it executes commands from the file '.logout' in the 
users home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the following excep- 
tions. The characters '&' 'I'.';' '<' '>' '(' ')' form separate words. If doubled in '&&', 
'I I ', '«' or '»' these pairs form single words. These parser metacharacters may be 
made part of other words, or prevented their special meaning, by preceding them 
with 'V. A newline preceded by a 'V is equivalent to a blank. 

In addition strings enclosed in matched pairs of quotations, '", ' N ' or "", form parts of 
a word; metacharacters in these strings, including blanks and tabs, do not form 
separate words. These quotations have semantics to be described subsequently. 
Within pairs of "' or "" characters a newline preceded by a 'V gives a true newline 
character. 

When the shell's input is not a terminal, the character '#' introduces a comment 
which continues to the end of the input line. It is prevented this special meaning 
when preceded by 'V and in quotations using /N ', '", and "". 

Commands 

A simple command is a sequence of words, the first of which specifies the command 
to be executed. A simple command or a sequence of simple commands separated by 
' I ' characters forms a pipeline. The output of each command in a pipeline is con- 
nected to the input of the next. Sequences of pipelines may be separated by ';', and 
are then executed sequentially. A sequence of pipelines may be executed without 
immediately waiting for it to terminate by following it with an '&'. 

Any of the above may be placed in '(' ')' to form a simple command (which may be a 
component of a pipeline, etc.) It is also possible to separate pipelines with 'I I ' or 
'&&' indicating, as in the C language, that the second is to be executed only if the 
first fails or succeeds respectively. (See Expressions.) 
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Jobs 

The shell associates a job with each pipeline. It keeps a table of current jobs, printed 
by the jobs command, and assigns them small integer numbers. When a job is started 
asynchronously with '&', the shell prints a line which looks like: 

[1] 1234 

indicating that the job which was started asynchronously was job number 1 and had 
one (top-level) process, whose process id was 1234. 

If you are running a job and wish to do something else you may hit the key A Z 
(control-Z) which sends a STOP signal to the current job. The shell will then nor- 
mally indicate that the job has been 'Stopped', and print another prompt. You can 
then manipulate the state of this job, putting it in the background with the bg com- 
mand, or run some other commands and then eventually bring the job back into the 
foreground with the foreground command fg. A A Z takes effect immediately and is 
like an interrupt in that pending output and unread input are discarded when it is 
typed. There is another special key A Y which does not generate a STOP signal until a 
program attempts to read (2) it. This can usefully be typed ahead when you have 
prepared some commands for a job which you wish to stop after it has read them. 

A job being run in the background will stop if it tries to read from the terminal. 
Background jobs are normally allowed to produce output, but this can be disabled by 
giving the command "stty tostop". If you set this tty option, then background jobs 
will stop when they try to produce output like they do when they try to read input. 

There are several ways to refer to jobs in the shell. The character '%' introduces a job 
name. If you wish to refer to job number 1, you can name it as '%!'. Just naming a 
job brings it to the foreground; thus '%1' is a synonym for 'fg %Y, bringing job 1 back 
into the foreground. Similarly saying '%! &' resumes job 1 in the background. Jobs 
can also be named by prefixes of the string typed in to start them, if these prefixes are 
unambiguous, thus '%ex' would normally restart a suspended ex{\) job, if there were 
only one suspended job whose name began with the string 'ex'. It is also possible to 
say '%?string' which specifies a job whose text contains string, if there is only one 
such job. 

The shell maintains a notion of the current and previous jobs. In output pertaining to 
jobs, the current job is marked with a V and the previous job with a '-'. The abbrevi- 
ation '%+' refers to the current job and '%-' refers to the previous job. For close anal- 
ogy with the syntax of the history mechanism (described below), '%%' is also a 
synonym for the current job. 

Status reporting 

This shell learns immediately whenever a process changes state. It normally informs 
you whenever a job becomes blocked so that no further progress is possible, but only 
just before it prints a prompt. This is done so that it does not otherwise disturb your 
work. If, however, you set the shell variable notify, the shell will notify you immedi- 
ately of changes of status in background jobs. There is also a shell command notify 
which marks a single process so that its status changes will be immediately reported. 
By default notify marks the current process; simply say 'notify' after starting a back- 
ground job to mark it. 

When you try to leave the shell while jobs are stopped, you will be warned that Tou 
have stopped jobs.' You may use the jobs command to see what they are. If you do 
this or immediately try to exit again, the shell will not warn you a second time, and 
the suspended jobs will be terminated. 
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File Name Completion 

When the file name completion feature is enabled by setting the shell variable filec 
(see set), csh will interactively complete file names and user names from unique 
prefixes, when they are input from the terminal followed by the escape character (the 
escape key, or controH). For example, if the current directory looks like 

DSC.OLD bin cmd lib xmpl.c 

DSC.NEW chaosnet cmtest mail xmpl.o 

bench class dev mbox xmpl.out 

and the input is 

% vi ch<escape> 
csh will complete the prefix "ch" to the only matching file name "chaosnet", chang- 
ing the input line to 

% vi chaosnet 
However, given 

% vi D<escape> 
csh will only expand the input to 

%viDSC. 
and will sound the terminal bell to indicate that the expansion is incomplete, since 
there are two file names matching the prefix "D". 

If a partial file name is followed by the end-of-file character (usually control-D), then, 
instead of completing the name, csh will list all file names matching the prefix. For 
example, the input 

% vi D<control-D> 
causes all files beginning with "D" to be listed: 

DSC.NEW DSC.OLD 

while the input line remains unchanged. 

The same system of escape and end-of-file can also be used to expand partial user 
names, if the word to be completed (or listed) begins with the character "~". For 
example, typing 

cd ~ro<control-D> 
may produce the expansion 

cd -root 

The use of the terminal bell to signal errors or multiple matches can be inhibited by 
setting the variable nobeep. 

Normally, all files in the particular directory are candidates for name completion. 
Files with certain suffixes can be excluded from consideration by setting the variable 
fignore to the list of suffixes to be ignored. Thus, if fignore is set by the command 

% set fignore = (.o .out) 
then typing 

% vi x<escape> 
would result in the completion to 

% vi xmpl.c 
ignoring the files "xmpl.o" and "xmpl.out". However, if the only completion possible 
requires not ignoring these suffixes, then they are not ignored. In addition, fignore 
does not affect the listing of file names by control-D. All files are listed regardless of 
their suffixes. 

Substitutions 

We now describe the various transformations the shell performs on the input in the 
order in which they occur. 
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History substitutions 

History substitutions place words from previous command input as portions of new 
commands, making it easy to repeat commands, repeat arguments of a previous 
command in the current command, or fix spelling mistakes in the previous command 
with little typing and a high degree of confidence. History substitutions begin with 
the character '!' and may begin anywhere in the input stream (with the proviso that 
they do not nest.) This '!' may be preceded by an 'V to prevent its special meaning; 
for convenience, a '!' is passed unchanged when it is followed by a blank, tab, new- 
line, '=' or '('. (History substitutions also occur when an input line begins with 'T'. 
This special abbreviation will be described later.) Any input line which contains his- 
tory substitution is echoed on the terminal before it is executed as it could have been 
typed without history substitution. 

Commands input from the terminal which consist of one or more words are saved on 
the history list. The history substitutions reintroduce sequences of words from these 
saved commands into the input stream. The size of which is controlled by the history 
variable; the previous command is always retained, regardless of its value. Com- 
mands are numbered sequentially from 1. 

For definiteness, consider the following output from the his tory command: 

9 write michael 

10 ex write.c 

11 cat old write.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not usually necessary to 

use event numbers, but the current event number can be made part of the prompt by ^ 

placing an '!' in the prompt string. I 

With the current event 13 we can refer to previous events by event number '111', rela- 
tively as in '!-2' (referring to the same event), by a prefix of a command word as in 
'!d' for event 12 or '!wri' for event 9, or by a string contained in a word in the com- 
mand as in '!?mic?' also referring to event 9. These forms, without further 
modification, simply reintroduce the words of the specified events, each separated by 
a single blank. As a special case '!!' refers to the previous command; thus '!!' alone is 
essentially a redo. 

To select words from an event we can follow the event specification by a ':' and a 
designator for the desired words. The words of an input line are numbered from 0, 
the first (usually command) word being 0, the second word (first argument) being 1,, 
etc. The basic word designators are: 

first (command) word 

n n 'th argument 

t first argument, i.e. T 

$ last argument 

% word matched by (immediately preceding) ?s ? search 

x-y range of words 

-y abbreviates '0-y' 

* abbreviates 'T-$', or nothing if only 1 word in event 

x * abbreviates 'x -$' 

x- like 'x *' but omitting word '$' 

The ':' separating the event specification from the word designator can be omitted if 
the argument selector begins with a 'T', '$', '*' '-' or '%'. After the optional word 
designator can be placed a sequence of modifiers, each preceded by a ':'. The follow- 
ing modifiers are defined: 
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h Remove a trailing pathname component, leaving the head. 

r Remove a trailing '.xxx' component, leaving the root name. 

e Remove all but the extension '.xxx' part. 

s/Z lr I Substitute I for r 

t Remove all leading pathname components, leaving the tail. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. 'g&'. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 

x Like q, but break into words at blanks, tabs and newlines. 

Unless preceded by a 'g' the modification is applied only to the first modifiable 
word. With substitutions, it is an error for no word to be applicable. 

The left hand side of substitutions are not regular expressions in the sense of the edi- 
tors, but rather strings. Any character may be used as the delimiter in place of '/'; a 
'V quotes the delimiter into the I and y strings. The character '&' in the right hand 
side is replaced by the text from the left. A 'V quotes '&' also. A null I uses the pre- 
vious string either from a I or from a contextual scan string s in '17s?'. The trailing 
delimiter in the substitution may be omitted if a newline follows immediately as may 
the trailing '?' in a contextual scan. 

A history reference may be given without an event specification, e.g. '!$'. In this case 
the reference is to the previous command unless a previous history reference 
occurred on the same line in which case this form repeats the previous reference. 
Thus '!?foo?T !$' gives the first and last arguments from the command matching 
'?foo?'. 

A special abbreviation of a history reference occurs when the first non-blank charac- 
ter of an input line is a 'T'. This is equivalent to '!:sT' providing a convenient short- 
hand for substitutions on the text of the previous line. Thus 'TlbTlib' fixes the spel- 
ling of 'lib' in the previous command. Finally, a history substitution may be sur- 
rounded with '{' and '}' if necessary to insulate it from the characters which follow. 
Thus, after Is -Id -paul' we might do '!{l)a' to do Is -Id -paula', while '!la' would 
look for a command starting la'. 

Quotations with ' and " 

The quotation of strings by "' and "" can be used to prevent all or some of the 
remaining substitutions. Strings enclosed in '" are prevented any further interpreta- 
tion. Strings enclosed in "" may be expanded as described below. 

In both cases the resulting text becomes (all or part of) a single word; only in one spe- 
cial case (see Command Substitition below) does a "" quoted string yield parts of more 
than one word; '"' quoted strings never do. 

Alias substitution 

The shell maintains a list of aliases which can be established, displayed and modified 
by the alias and unalias commands. After a command line is scanned, it is parsed into 
distinct commands and the first word of each command, left-to-right, is checked to 
see if it has an alias. If it does, then the text which is the alias for that command is 
reread with the history mechanism available as though that command were the pre- 
vious input line. The resulting words replace the command and argument list. If no 
reference is made to the history list, then the argument list is left unchanged. 

Thus if the alias for Is' is Is -1' the command Is /usr' would map to 'Is -1 /usr', the 
argument list here being undisturbed. Similarly if the alias for lookup' was 'grep it 
/etc/passwd' then 'lookup bill' would map to 'grep bill /etc/passwd'. 
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If an alias is found, the word transformation of the input text is performed and the | 

aliasing process begins again on the reformed input line. Looping is prevented if the V. 

first word of the new text is the same as the old by flagging it to prevent further alias- 
ing. Other loops are detected and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can 
'alias print 'pr \!* I Ipr'' to make a command which ipr's its arguments to the line 
printer. 

Variable substitution 

The shell maintains a set of variables, each of which has as value a list of zero or more 
words. Some of these variables are set by the shell or referred to by it. For instance, 
the argv variable is an image of the shell's argument list, and words of this variable's 
value are referred to in special ways. 

The values of variables may be displayed and changed by using the set and unset 
commands. Of the variables referred to by the shell a number are toggles; the shell 
does not care what their value is, only whether they are set or not. For instance, the 
verbose variable is a toggle which causes command input to be echoed. The setting of 
this variable results from the -v command line option. 

Other operations treat variables numerically. The '%' command permits numeric cal- 
culations to be performed and the result assigned to a variable. Variable values are, 
however, always represented as (zero or more) strings. For the purposes of numeric 
operations, the null string is considered to be zero, and the second and subsequent 
words of multiword values are ignored. 

After the input line is aliased and parsed, and before each command is executed, 
variable substitution is performed keyed by '$' characters. This expansion can be 
prevented by preceding the '$' with a 'V except within /n/ s where it always occurs, 
and within "'$ where it never occurs. Strings quoted by t%f are interpreted later (see 
Command substitution below) so '$' substitution does not occur there until later, if at 
all. A '$' is passed unchanged if followed by a blank, tab, or end-of-line. 

Input /output redirections are recognized before variable expansion, and are variable 
expanded separately. Otherwise, the command name and entire argument list are 
expanded together. It is thus possible for the first (command) word to this point to 
generate more than one word, the first of which becomes the command name, and 
the rest of which become arguments. 

Unless enclosed in '"' or given the ':q' modifier the results of variable substitution 
may eventually be command and filename substituted. Within '"', a variable whose 
value consists of multiple words expands to a (portion of) a single word, with the 
words of the variables value separated by blanks. When the ':q' modifier is applied 
to a substitution the variable will expand to multiple words with each word 
separated by a blank and quoted to prevent later command or filename substitution. 

The following metasequences are provided for introducing variable values into the 
shell input. Except as noted, it is an error to reference a variable which is not set. 

$name 

$(name) 

Are replaced by the words of the value of variable name, each separated by a 

blank. Braces insulate name from following characters which would otherwise 

be part of it. Shell variables have names consisting of up to 20 letters and digits 

starting with a letter. The underscore character is considered a letter. 

If name is not a shell variable, but is set in the environment, then that value is ^ 

returned (but : modifiers and the other forms given below are not available in f 



this case). 



( 
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$name[selector] 

${name[selector]} 

May be used to select only some of the words from the value of name. The selec- 
tor is subjected to '$' substitution and may consist of a single number or two 
numbers separated by a '-'. The first word of a variables value is numbered '1'. 
If the first number of a range is omitted it defaults to '1'. If the last member of a 
range is omitted it defaults to / $#name / . The selector '*' selects all words. It is 
not an error for a range to be empty if the second argument is omitted or in 
range. 

$#name 
${#name} 

Gives the number of words in the variable. This is useful for later use in a 

'[selector]'. 



$0 



Substitutes the name of the file from which command input is being read. An 
error occurs if the name is not known. 



$number 
$ {number} 

Equivalent to '$argv[number]'. 

$* 

Equivalent to '$argv[*]'. 

The modifiers ':h', ':t', ':r', ':q' and ':x' may be applied to the substitutions above as 
may ':gh', ':gt' and ':gr'. If braces '{' '}' appear in the command form then the 
modifiers must appear within the braces. The current implementation allows only 
one ':' modifier on each '$' expansion. 

The following substitutions may not be modified with ':' modifiers. 

$?name 
$(?name) 

Substitutes the string '1' if name is set, '0' if it is not. 

$?0 

Substitutes '1/ if the current input filename is known, '0' if it is not. 

$$ 

Substitute the (decimal) process number of the (parent) shell. 

$< 

Substitutes a line from the standard input, with no further interpretation 
thereafter. It can be used to read from the keyboard in a shell script. 

Command and filename substitution 

The remaining substitutions, command and filename substitution, are applied selec- 
tively to the arguments of builtin commands. This means that portions of expres- 
sions which are not evaluated are not subjected to these expansions. For commands 
which are not internal to the shell, the command name is substituted separately from 
the argument list. This occurs very late, after input-output redirection is performed, 
and in a child of the main shell. 

Command substitution 

Command substitution is indicated by a command enclosed in /x/ . The output from 
such a command is normally broken into separate words at blanks, tabs and new- 
lines, with null words being discarded, this text then replacing the original string. 
Within /M/ s, only newlines force new words; blanks and tabs are preserved. 
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In any case, the single final newline does not force a new word. Note that it is thus I 

possible for a command substitution to yield only part of a word, even if the com- ^ 

mand outputs a complete line. 

Filename substitution 

If a word contains any of the characters '*', '?', '['. or '{' or begins with the character 
'~ , then that word is a candidate for filename substitution, also known as 'globbing'. 
This word is then regarded as a pattern, and replaced with an alphabetically sorted 
list of file names which match the pattern. In a list of words specifying filename sub- 
stitution it is an error for no pattern to match an existing file name, but it is not 
required for each pattern to match. Only the metacharacters '*', '?' and '[' imply pat- 
tern matching, the characters '-' and '{' being more akin to abbreviations. 

In matching filenames, the character '.' at the beginning of a filename or immediately 
following a '/', as well as the character '/' must be matched explicitly. The character 
'*' matches any string of characters, including the null string. The character '?' 
matches any single character. The sequence '[...]' matches any one of the characters 
enclosed. Within '[...]', a pair of characters separated by '-' matches any character 
lexically between the two. 

The character '~' at the beginning of a filename is used to refer to home directories. 
Standing alone, i.e. '~' it expands to the invokers home directory as reflected in the 
value of the variable home. When followed by a name consisting of letters, digits and 
'-' characters the shell searches for a user with that name and substitutes their home 
directory; thus '-ken' might expand to '/usr/ken' and '-ken/chmach' to 
'/usr/ken/chmach'. If the character '-' is followed by a character other than a letter 
or '/' or appears not at the beginning of a word, it is left undisturbed. 

The metanotation 'a{b,c,d}e' is a shorthand for 'abe ace ade'. Left to right order is 
preserved, with results of matches being sorted separately at a low level to preserve 
this order. This construct may be nested. Thus '~source/sl/{oldls,ls}.c' expands to 
'/usr/source/sl/oldls.c /usr/source/sl/ls.c' whether or not these files exist 
without any chance of error if the home directory for 'source' is '/usr/source'. Simi- 
larly '../{memo,*box}' might expand to '../memo ../box ../mbox'. (Note that 'memo 7 
was not sorted with the results of matching '*box'.) As a special case '{', '}' and '{}' 
are passed undisturbed. 

Input/output 

The standard input and standard output of a command may be redirected with the 
following syntax: 

< name 

Open file name (which is first variable, command and filename expanded) as 
the standard input. 

« word 

Read the shell input up to a line which is identical to word. Word is not sub- 
jected to variable, filename or command substitution, and each input line is 
compared to word before any substitutions are done on this input line. Unless a 
quoting 'V, "", "' or /v/ appears in word variable and command substitution is 
performed on the intervening lines, allowing 'V to quote '$', 'V and /s/ . Com- 
mands which are substituted have all blanks, tabs, and newlines preserved, 
except for the final newline which is dropped. The resultant text is placed in an 
anonymous temporary file which is given to the command as standard input. 

> name 



( 



c 
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>! name 

>& name 

>&! name 

The file name is used as standard output. If the file does not exist then it is 
created; if the file exists, its is truncated, its previous contents being lost. 

If the variable noclobber is set, then the file must not exist or be a character spe- 
cial file (e.g. a terminal or 7dev/null') or an error results. This helps prevent 
accidental destruction of files. In this case the '!' forms can be used and 
suppress this check. 

The forms involving '&' route the diagnostic output into the specified file as 
well as the standard output. Name is expanded in the same way as '<' input 
filenames are. 

» name 

»& name 

»! name 

»&! name 

Uses file name as standard output like '>' but places output at the end of the 
file. If the variable noclobber is set, then it is an error for the file not to exist 
unless one of the '!' forms is given. Otherwise similar to '>'. 

A command receives the environment in which the shell was invoked as modified by 
the input-output parameters and the presence of the command in a pipeline. Thus, 
unlike some previous shells, commands run from a file of shell commands have no 
access to the text of the commands by default; rather they receive the original stan- 
dard input of the shell. The '«' mechanism should be used to present inline data. 
This permits shell command scripts to function as components of pipelines and 
allows the shell to block read its input. Note that the default standard input for a 
command run detached is not modified to be the empty file '/dev/null'; rather the 
standard input remains as the original standard input of the shell. If this is a termi- 
nal and if the process attempts to read from the terminal, then the process will block 
and the user will be notified (see Jobs above). 

Diagnostic output may be directed through a pipe with the standard output. Simply 
use the form ' I &' rather than just ' I'. 

Expressions 

A number of the builtin commands (to be described subsequently) take expressions, 
in which the operators are similar to those of C, with the same precedence. These 
expressions appear in the @, exit, if, and while commands. The following operators 
are available: 

| | && | T &==!==-!- <=>=<>«» + -*/%!-( ) 

Here the precedence increases to the right, '==' '!=' '=-' and '!-', '<=' '>=' '<' and V, 
'«' and '»', '+' and '-', '*' '/' and '%' being, in groups, at the same level. The '==' 
'!=' '=~' and '!-' operators compare their arguments as strings; all others operate on 
numbers. The operators '=-' and '!-' are like '!=' and '==' except that the right hand 
side is a -pattern (containing, e.g. '*'s, '?'s and instances of '[..JO against which the left 
hand operand is matched. This reduces the need for use of the switch statement in 
shell scripts when all that is really needed is pattern matching. 

Strings which begin with '0' are considered octal numbers. Null or missing argu- 
ments are considered '()'. The result of all expressions are strings, which represent 
decimal numbers. It is important to note that no two components of an expression 
can appear in the same word; except when adjacent to components of expressions 
which are syntactically significant to the parser ('&' ' V '<' '>' '(' 00 they should be 
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surrounded by spaces. I 

Also available in expressions as primitive operands are command executions 
enclosed in '{' and '}' and file enquiries of the form '-Z name' where I is one of: 

r read access 

w write access 

x execute access 

e existence 

ownership 
z zero size 

f plain file 

d directory 

1 symbolic link 

The specified name is command and filename expanded and then tested to see if it 
has the specified relationship to the real user. If the file does not exist or is inaccessi- 
ble then all enquiries return false, i.e. '0'. Command executions succeed, returning 
true, i.e. T, if the command exits with status 0, otherwise they fail, returning false, 
i.e. '0'. If more detailed status information is required then the command should be 
executed outside of an expression and the variable status examined. 

Control flow 

The shell contains a number of commands which can be used to regulate the flow of 
control in command files (shell scripts) and (in limited but useful ways) from termi- 
nal input. These commands all operate by forcing the shell to reread or skip in its 
input and, due to the implementation, restrict the placement of some of the com- 
mands. 



The preach, switch, and while statements, as well as the if-then-else form of the if state- 
ment require that the major keywords appear in a single simple command on an 
input line as shown below. 

If the shell's input is not seekable, the shell buffers up input whenever a loop is being 
read and performs seeks in this internal buffer to accomplish the rereading implied 
by the loop. (To the extent that this allows, backward goto's will succeed on non- 
seekable inputs.) 

Builtin commands 

Builtin commands are executed within the shell. If a builtin command occurs as any 
component of a pipeline except the last then it is executed in a subshell. 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form prints the alias for name. The 
final form assigns the specified wordlist as the alias of name; wordlist is com- 
mand and filename substituted. Name is not allowed to be alias or unalias. 



alloc 



Shows the amount of dynamic memory acquired, broken down into used and 
free memory. With an argument shows the number of free and used blocks in 
each size category. The categories start at size 8 and double at each step. This 
command's output may vary across system types, since systems other than the 
VAX may use a different memory allocator. 



bg 



( 



( 
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bg %job ... 

Puts the current or specified jobs into the background, continuing them if they 
were stopped. 

break 

Causes execution to resume after the end of the nearest enclosing preach or 
while. The remaining commands on the current line are executed. Multi-level 
breaks are thus possible by writing them all on one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 

case label: 

A label in a switch statement as discussed below. 

cd 

cd name 

chdir 

chdir name 

Change the shell's working directory to directory name. If no argument is given 
then change to the home directory of the user. 

If name is not found as a subdirectory of the current directory (and does not 
begin with '/', './' or '../'), then each component of the variable cdpath is 
checked to see if it has a subdirectory name. Finally, if all else fails but name is a 
shell variable whose value begins with '/', then this is tried to see if it is a direc- 
tory. 

continue 

Continue execution of the nearest enclosing while or foreach. The rest of the com- 
mands on the current line are executed. 

default: 

Labels the default case in a switch statement. The default should come after all 
case labels. 

dirs 

Prints the directory stack; the top of the stack is at the left, the first directory in 
the stack being the current directory. 

echo wordlist 

echo -n wordlist 

The specified words are written to the shells standard output, separated by 
spaces, and terminated with a newline unless the -n option is specified. 

else 
end 
endif 
endsw 

See the description of the foreach, if, switch, and while statements below. 

evalarg... 

(As in sh(l).) The arguments are read as input to the shell and the resulting 
command(s) executed in the context of the current shell. This is usually used to 
execute commands generated as the result of command or variable substitu- 
tion, since parsing occurs before these substitutions. See tsetd) for an example 
of using eval. 

exec command 

The specified command is executed in place of the current shell. 
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exit 

exit(expr) 

The shell exits either with the value of the status variable (first form) or with the 
value of the specified expr (second form). 

f g 

fg %job ... 

Brings the current or specified jobs into the foreground, continuing them if they 
were stopped. 

f or each name (wordlist) 

end 

The variable name is successively set to each member of wordlist and the 
sequence of commands between this command and the matching end are exe- 
cuted. (Both foreach and end must appear alone on separate lines.) 

The builtin command continue may be used to continue the loop prematurely 
and the builtin command break to terminate it prematurely. When this com- 
mand is read from the terminal, the loop is read up once prompting with '?' 
before any statements in the loop are executed. If you make a mistake typing in 
a loop at the terminal you can rub it out. 

glob wordlist 

Like echo but no 'V escapes are recognized and words are delimited by null 
characters in the output. Useful for programs which wish to use the shell to 
filename expand a list of words. 

goto word ^ 

The specified word is filename and command expanded to yield a string of the I 

form 'label'. The shell rewinds its input as much as possible and searches for a 
line of the form 'label:' possibly preceded by blanks or tabs. Execution contin- 
ues after the specified line. 

history 

history n 

history -tn 

history -h n 

Displays the history event list; if n is given only the n most recent events are 
printed. The -r option reverses the order of printout to be most recent first 
rather than oldest first. The -h option causes the history list to be printed 
without leading numbers. This is used to produce files suitable for sourceing 
using the -h option to source. 

if (expr) command 

If the specified expression evaluates true, then the single command with argu- 
ments is executed. Variable substitution on command happens early, at the 
same time it does for the rest of the // command. Command must be a simple 
command, not a pipeline, a command list, or a parenthesized command list. 
Input/output redirection occurs even if expr is false, when command is not exe- 
cuted (this is a bug). 

if (expr) then 
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endif 

If the specified expr is true then the commands to the first else are executed; oth- 
erwise if exprl is true then the commands to the second else are executed, etc. 
Any number of else-if pairs are possible; only one endif is needed. The else part 
is likewise optional. (The words else and endif must appear at the beginning of 
input lines; the if must appear alone on its input line or after an else.) 

jobs 

jobs-1 

Lists the active jobs; given the -1 options lists process id's in addition to the nor- 
mal information. 

kill %job 

kill-sig%job ... 

killpid 

kill-sigpid ... 

kill -1 

Sends either the TERM (terminate) signal or the specified signal to the specified 
jobs or processes. Signals are either given by number or by names (as given in 
/usr/include/signalh, stripped of the prefix "SIG"). The signal names are listed 
by "kill -1". There is no default, saying just 'kill' does not send a signal to the 
current job. If the signal being sent is TERM (terminate) or HUP (hangup), then 
the job or process will be sent a GONT (continue) signal as well. 

limit 

limit resource 

limit resource maximum-use 

limit -h 

limit -h resource 

limit -h resource maximum-use 

NOTE: This command is not supported on the Stardent 1500/3000. All limits 
are set to zero. You can set any of the limits, but you do nothing but modify 
some local variables. 

Limits the consumption by the current process and each process it creates to 
not individually exceed maximum-use on the specified resource. If no maximum- 
use is given, then the current limit is printed; if no resource is given, then all lim- 
itations are given. If the -h flag is given, the hard limits are used instead of the 
current limits. The hard limits impose a ceiling on the values of the current lim- 
its. Only the super-user may raise the hard limits, but a user may lower or raise 
the current limits within the legal range. 

Resources controllable currently include cputime (the maximum number of 
cpu-seconds to be used by each process), filesize (the largest single file which 
can be created), datasize (the maximum growth of the data+stack region via 
sbrk(2) beyond the end of the program text), stacksize (the maximum size of the 
automatically-extended stack region), and coredumpsize (the size of the largest 
core dump that will be created). 

The maximum-use may be given as a (floating point or integer) number followed 
by a scale factor. For all limits other than cputime the default scale is 'k' or 'kilo- 
bytes' (1024 bytes); a scale factor of 'm' or 'megabytes' may also be used. For 
cputime the default scaling is 'seconds', while 'm' for minutes or T\' for hours, or 
a time of the form 'mm:ss' giving minutes and seconds may be used. 
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For both resource names and scale factors, unambiguous prefixes of the names i 

suffice. V 

login 

Terminate a login shell, replacing it with an instance of /bin/login. This is one 
way to log off, included for compatibility with sh(l). 

logout 

Terminate a login shell. Especially useful if ignoreeof is set. 

nice 

nice+number 

nice command 

nice +number command 

The first form sets the scheduling priority for this shell to 4. The second form 
sets the priority to the given number. The final two forms run command at 
priority 4 and number respectively. The greater the number, the less cpu the 
process will get. The super-user may specify negative priority by using 'nice 
-number../. Command is always executed in a sub-shell, and the restrictions 
placed on commands in simple if statements apply. 

nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be ignored for the 
remainder of the script. The second form causes the specified command to be 
run with hangups ignored. All processes detached with '&' are effectively 
nohup'ed. 

notify j- 

notify % job ... | 

Causes the shell to notify the user asynchronously when the status of the ^- 

current or specified jobs changes; normally notification is presented before a 
prompt. This is automatic if the shell variable notify is set. 

onintr 

onintr - 

onintr label 

Control the action of the shell on interrupts. The first form restores the default 
action of the shell on interrupts which is to terminate shell scripts or to return 
to the terminal command input level. The second form 'onintr - causes all 
interrupts to be ignored. The final form causes the shell to execute a 'goto label 7 
when an interrupt is received or a child process terminates because it was inter- 
rupted. 

In any case, if the shell is running detached and interrupts are being ignored, 
all forms of onintr have no meaning and interrupts continue to be ignored by 
the shell and all invoked commands. 

popd 

popd+n 

Pops the directory stack, returning to the new top directory. With an argument 
'+n 7 discards the nth entry in the stack. The elements of the directory stack are 
numbered from starting at the top. 

pushd 

pushd name 

pushd +n 

With no arguments, pushd exchanges the top two elements of the directory 
stack. Given a name argument, pushd changes to the new directory (ala cd) and 
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pushes the old current working directory (as in cszv) onto the directory stack. 
With a numeric argument, rotates the nth argument of the directory stack 
around to be the top element and changes to it. The members of the directory 
stack are numbered from the top starting at 0. 

rehash 

Causes the internal hash table of the contents of the directories in the path vari- 
able to be recomputed. This is needed if new commands are added to direc- 
tories in the path while you are logged in. This should only be necessary if you 
add commands to one of your own directories, or if a systems programmer 
changes the contents of one of the system directories. 

repeat count command 

The specified command which is subject to the same restrictions as the command 
in the one line if statement above, is executed count times. I/O redirections 
occur exactly once, even if count is 0. 

set 

set name 

set name=word 

set name[index]=word 

set name=(wordlist) 

The first form of the command shows the value of all shell variables. Variables 
which have other than a single word as value print as a parenthesized word 
list. The second form sets name to the null string. The third form sets name to 
the single word. The fourth form sets the index 'th component of name to word; 
this component must already exist. The final form sets name to the list of words 
in wordlist. In all cases the value is command and filename expanded. 

These arguments may be repeated to set multiple values in a single set com- 
mand. Note however, that variable expansion happens for all arguments 
before any setting occurs. 

setenv 

setenv name value 

setenv name 

The first form lists all current environment variables. The last form sets the 
value of environment variable name to be value, a single string. The second 
form sets name to an empty string. The most commonly used environment 
variable USER, TERM, and PATH are automatically imported to and exported 
from the csh variables user, term, and path; there is no need to use setenv for 
these. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argv[l]. It is an error for 
argv not to be set or to have less than one word as value. The second form per- 
forms the same function on the specified variable. 

source name 

source -h name 

The shell reads commands from name. Source commands may be nested; if they 
are nested too deeply the shell may run out of file descriptors. An error in a 
source at any level terminates all nested source commands. Normally input dur- 
ing source commands is not placed on the history list; the -h option causes the 
commands to be placed in the history list without being executed. 
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stop 

stop %job ... 

Stops the current or specified job which is executing in the background. 

suspend 

Causes the shell to stop in its tracks, much as if it had been sent a stop signal 
with A Z. This is most often used to stop shells started by su(l). 

switch (string) 
casestrl: 

breaksw 

default: 

breaksw 
endsw 

Each case label is successively matched, against the specified string which is 
first command and filename expanded. The file metacharacters '*', '?' and '[...]' 
may be used in the case labels, which are variable expanded. If none of the 
labels match before a 'default' label is found, then the execution begins after the 
default label. Each case label and the default label must appear at the begin- 
ning of a line. The command breaksw causes execution to continue after the 
endsw. Otherwise control may fall through case labels and default labels as in C. 
If no label matches and there is no default, execution continues after the endsw. 

time 

time command 

With no argument, a summary of time used by this shell and its children is 
printed. If arguments are given the specified simple command is timed and a 
time summary as described under the time variable is printed. If necessary, an 
extra shell is created to print the time statistic when the command completes. 

umask 

umask value 

The file creation mask is displayed (first form) or set to the specified value 
(second form). The mask is given in octal. Common values for the mask are 
002 giving all access to the group and read and execute access to others or 022 
giving all access except no write access for users in the group or others. 

unalias pattern 

All aliases whose names match the specified pattern are discarded. Thus all 
aliases are removed by 'unalias *'. It is not an error for nothing to be unaliased. 

unhash 

Use of the internal hash table to speed location of executed programs is dis- 
abled. 

unlimit 

unlimit resource 

unlimit -h 

unlimit -h resource 

Removes the limitation on resource. If no resource is specified, then all resource 
limitations are removed. If -h is given, the corresponding hard limits are 
removed. Only the super-user may do this. 

unset pattern 

All variables whose names match the specified pattern are removed. Thus all 
variables are removed by 'unset *'; this has noticeably distasteful side-effects. 
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It is not an error for nothing to be unset. 

unsetenv pattern 

Removes all variables whose name match the specified pattern from the 
environment. See also the setenv command above and printenv(l). 

wait 

All background jobs are waited for. It the shell is interactive, then an interrupt 
can disrupt the wait, at which time the shell prints names and job numbers of 
all jobs known to be outstanding. 

while (expr) 

end 

While the specified expression evaluates non-zero, the commands between the 
while and the matching end are evaluated. Break and continue may be used to 
terminate or continue the loop prematurely. (The while and end must appear 
alone on their input lines.) Prompting occurs here the first time through the 
loop as for the for each statement if the input is a terminal. 

%job 

Brings the specified job into the foreground. 

%job & 

Continues the specified job in the background. 

@ 

@ name = expr 

@ name[index] = expr 

The first form prints the values of all the shell variables. The second form sets 
the specified name to the value of expr. If the expression contains '<', '>', '&' or 
' I ' then at least this part of the expression must be placed within '(' ')'. The 
third form assigns the value of expr to the index' th argument of name. Both name 
and its index' th component must already exist. 

The operators '*=', '+=', etc are available as in C. The space separating the 
name from the assignment operator is optional. Spaces are, however, manda- 
tory in separating components of expr which would otherwise be single words. 

Special postfix '++' and ' — ' operators increment and decrement name respec- 
tively, i.e. '@ i++'. 
Pre-defined and environment variables 

The following variables have special meaning to the shell. Of these, argv, cwd, home, 
path, prompt, shell and status are always set by the shell. Except for cwd and status this 
setting occurs only at initialization; these variables will not then be modified unless 
this is done explicitly by the user. 

This shell copies the environment variable USER into the variable user, TERM into 
term, and HOME into home, and copies these back into the environment whenever 
the normal shell variables are reset. The environment variable PATH is likewise han- 
dled; it is not necessary to worry about its setting other than in the file .cshrc as infe- 
rior csh processes will import the definition of path from the environment, and re- 
export it if you then change it. 

argv Set to the arguments to the shell, it is from this variable that posi- 

tional parameters are substituted, i.e. '$1' is replaced by '$argv[l]', 
etc. 
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cdpath 

cwd 
echo 



histchars 



history 



home 
ignoreeof 

mail 



noclobber 
noglob 

nonomatch 

notify 
path 



Gives a list of alternate directories searched to find subdirectories in 
chdir commands. 

The full pathname of the current directory. 

Set when the -x command line option is given. Causes each com- 
mand and its arguments to be echoed just before it is executed. For 
non-builtin commands all expansions occur before echoing. Builtin 
commands are echoed before command and filename substitution, 
since these substitutions are then done selectively. 

Can be given a string value to change the characters used in history 
substitution. The first character of its value is used as the history 
substitution character, replacing the default character !. The second 
character of its value replaces the character t in quick substitutions. 

Can be given a numeric value to control the size of the history list. 
Any command which has been referenced in this many events will 
not be discarded. Too large values of history may run the shell out 
of memory. The last executed command is always saved on the his- 
tory list. 

The home directory of the invoker, initialized from the environ- 
ment. The filename expansion of '-' refers to this variable. 

If set the shell ignores end-of-file from input devices which are ter- 
minals. This prevents shells from accidentally being killed by 
control-D's. 

The files where the shell checks for mail. This is done after each 
command completion which will result in a prompt, if a specified 
interval has elapsed. The shell says 'You have new mail/ if the file 
exists with an access time not greater than its modify time. 

If the first word of the value of mail is numeric it specifies a different 
mail checking interval, in seconds, than the default, which is 10 
minutes. 

If multiple mail files are specified, then the shell says 'New mail in 
name' when there is mail in the file name. 

As described in the section on Input/output, restrictions are placed 
on output redirection to insure that files are not accidentally des- 
troyed, and that '»' redirections refer to existing files. 

If set, filename expansion is inhibited. This is most useful in shell 
scripts which are not dealing with filenames, or after a list of 
filenames has been obtained and further expansions are not desir- 
able. 

If set, it is not an error for a filename expansion to not match any 
existing files; rather the primitive pattern is returned. It is still an 
error for the primitive pattern to be malformed, i.e. 'echo [' still 
gives an error. 

If set, the shell notifies asynchronously of job completions. The 
default is to rather present job completions just before printing a 
prompt. 

Each word of the path variable specifies a directory in which com- 
mands are to be sought for execution. A null word specifies the 
current directory. If there is no path variable then only full path 
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names will execute. The usual search path is '.', '/bin' and 
'/usr/bin', but this may vary from system to system. For the 
super-user the default search path is '/etc', '/bin' and '/usr/bin 7 . A 
shell which is given neither the -c nor the -t option will normally 
hash the contents of the directories in the path variable after reading 
.cshrc, and each time the path variable is reset. If new commands are 
added to these directories while the shell is active, it may be neces- 
sary to give the rehash or the commands may not be found. 

prompt The string which is printed before each command is read from an 

interactive terminal input. If a '!' appears in the string it will be 
replaced by the current event number unless a preceding 'Y is 
given. Default is '% ', or '# ' for the super-user. 

savehist is given a numeric value to control the number of entries of the his- 

tory list that are saved in -/.history when the user logs out. Any 
command which has been referenced in this many events will be 
saved. During start up the shell sources ~/. history into the history 
list enabling history to be saved across logins. Too large values of 
savehist will slow down the shell during start up. 

shell The file in which the shell resides. This is used in forking shells to 

interpret files which have execute bits set, but which are not execut- 
able by the system. (See the description of Non-builtin Command 
Execution below.) Initialized to the (system-dependent) home of the 
shell. 

status The status returned by the last command. If it terminated abnor- 

mally, then 0200 is added to the status. Builtin commands which 
fail return exit status T, all other builtin commands set status '0'. 

time Controls automatic timing of commands. If set, then any command 

which takes more than this many cpu seconds will cause a line giv- 
ing user, system, and real times and a utilization percentage which 
is the ratio of user plus system times to real time to be printed when 
it terminates. 

verbose Set by the -v command line option, causes the words of each com- 

mand to be printed after history substitution. 

Non-builtin command execution 

When a command to be executed is found to not be a builtin command the shell 
attempts to execute the command via execve(2). Each word in the variable path 
names a directory from which the shell will attempt to execute the command. If it is 
given neither a -c nor a -t option, the shell will hash the names in these directories 
into an internal table so that it will only try an exec in a directory if there is a possibil- 
ity that the command resides there. This greatly speeds command location when a 
large number of directories are present in the search path. If this mechanism has 
been turned off (via unhash), or if the shell was given a -c or -t argument, and in any 
case for each directory component of path which does not begin with a '/', the shell 
concatenates with the given command name to form a path name of a file which it 
then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus '(cd ; pwd) ; pwd' 
prints the home directory; leaving you where you were (printing this after the home 
directory), while 'cd ; pwd' leaves you in the home directory. Parenthesized com- 
mands are most often used to prevent chdir from affecting the current shell. 
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If the file has execute permissions but is not an executable binary to the system, then | 

it is assumed to be a file containing shell commands and a new shell is spawned to ^ 

read it. 

If there is an alias for shell then the words of the alias will be prepended to the argu- 
ment list to form the shell command. The first word of the alias should be the full 
path name of the shell (e.g. '$shell'). Note that this is a special, late occurring, case of 
alias substitution, and only allows words to be prepended to the argument list 
without modification. 

Argument list processing 

If argument to the shell is '-' then this is a login shell. The flag arguments are inter- 
preted as follows: 

-b This flag forces a "break" from option processing, causing any further shell 
arguments to be treated as non-option arguments. The remaining arguments 
will not be interpreted as shell options. This may be used to pass options to a 
shell script without confusion or possible subterfuge. The shell will not run a 
set-user ID script without this option. 

-c Commands are read from the (single) following argument which must be 
present. Any remaining arguments are placed in argv. 

-e The shell exits if any invoked command terminates abnormally or yields a 
non-zero exit status. 



-f The shell will start faster, because it will neither search for nor execute com- 
mands from the file '.cshrc' in the invoker's home directory. 

-i The shell is interactive and prompts for its top-level input, even if it appears to 
not be a terminal. Shells are interactive without this option if their inputs and 
outputs are terminals. 

-n Commands are parsed, but not executed. This aids in syntactic checking of 
shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A 'V may be used to escape the 
newline at the end of this line and continue onto another line. 

-v Causes the verbose variable to be set, with the effect that command input is 
echoed after history substitution. 

-x Causes the echo variable to be set, so that commands are echoed immediately 
before execution. 

-V Causes the verbose variable to be set even before '.cshrc' is executed. 

-X Is to -x as -V is to -v. 

After processing of flag arguments, if arguments remain but none of the -c, -i, -s, or 
-t options was given, the first argument is taken as the name of a file of commands to 
be executed. The shell opens this file, and saves its name for possible resubstitution 
by '$0'. Since many systems use either the standard version 6 or version 7 shells 
whose shell scripts are not compatible with this shell, the shell will execute such a 
'standard' shell if the first character of a script is not a '#', i.e. if the script does not 
start with a comment. Remaining arguments initialize the variable argv. 
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AUTHOR 



FILES 



LIMITATIONS 



SEE ALSO 



BUGS 



Signal handling 

The shell normally ignores quit signals. Jobs running detached (either by '&' or the 
bg or %... & commands) are immune to signals generated from the keyboard, includ- 
ing hangups. Other signals have the values which the shell inherited from its parent. 
The shells handling of interrupts and terminate signals in shell scripts can be con- 
trolled by onintr. Login shells catch the terminate signal; otherwise this signal is 
passed on to children from the state in the shell's parent. In no case are interrupts 
allowed when a login shell is reading the file '.logout'. 

William Joy. Job control and directory stack features first implemented by J.E. Kulp 
of I.I.A.S.A, Laxenburg, Austria, with different syntax than that used now. 



~/.cshrc 

-/.login 

-/.logout 

/bin/sh 

/tmp/sh* 

/etc/passwd 



Read at beginning of execution by each shell. 

Read by login shell, after '.cshrc' at login. 

Read by login shell, at logout. 

Standard shell, for shell scripts not starting with a '#'. 

Temporary file for '«'. 

Source of home directories for '-name'. 



Words can be no longer than 1024 characters. The system limits argument lists to 
10240 characters. The number of arguments to a command which involves filename 
expansion is limited to 1/6' th the number of characters allowed in an argument list. 
Command substitutions may substitute no more characters than are allowed in an 
argument list. To detect looping, the shell restricts the number of alias substitutions 
on a single line to 20. 

sh(l), stty(lB), access(2), execve(2), fork(2), killpg(2), pipe(2), sigvec(2), umask(2), 
setrlimit(2), wait(2), a.out(4) 

When a command is restarted from a stop, the shell prints the directory it started in if 
this is different from the current directory; this can be misleading (i.e. wrong) as the 
job may have changed directories internally. 

Shell builtin functions are not stoppable/restartable. Command sequences of the 
form 'a ; b ; c' are also not handled gracefully when stopping is attempted. If you 
suspend 'b', the shell will then immediately execute 'c'. This is especially noticeable 
if this expansion results from an alias. It suffices to place the sequence of commands 
in ()'s to force it to a subshell, i.e. '( a ; b ; c )'. 

Control over tty output after processes are started is primitive; perhaps this will 
inspire someone to work on a good virtual terminal interface. In a virtual terminal 
interface much more interesting things could be done with output control. 

Alias substitution is most often used to clumsily simulate shell procedures; shell pro- 
cedures should be provided rather than aliases. 

Commands within loops, prompted for by '?', are not placed in the history list. Con- 
trol structure should be parsed rather than being recognized as built-in commands. 
This would allow control commands to be placed anywhere, to be combined with ' I ', 
and to be used with '&' and ';' metasyntax. 

It should be possible to use the ':' modifiers on the output of command substitutions. 
All and more than one ':' modifier should be allowed on '$' substitutions. 
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csplit - context split 

csplit [-s] [-k] [-f prefix] file argl [. . . argn] 

csplit reads file and separates it into n+1 sections, defined by the arguments argl . . . 
argn. By default the sections are placed in xxOO . . . xxn (n may not be greater than 
99). These sections get the following pieces of file: 

00: From the start of file up to (but not including) the line referenced by 

argl. 
01: From the line referenced by argl up to the line referenced by argl . 



( 



EXAMPLES 



n+1: From the line referenced by argn to the end of file. 

If the file argument is a - then standard input is used. 

The options to csplit are: 

-s csplit normally prints the character counts for each file created. If the 

-s option is present, csplit suppresses the printing of all character 
counts. 

-k csplit normally removes created files if an error occurs. If the -k 

option is present, csplit leaves previously created files intact. 

-f prefix If the -f option is used, the created files are named prefixOO . . . 
prefixn. The default is xxOO .. . xxn. 

The arguments (argl . . . argn) to csplit can be a combination of the following: 

/rexp/ A file is to be created for the section from the current line up to (but 
not including) the line containing the regular expression rexp. The 
current line becomes the line containing rexp. This argument may be 
followed by an optional + or - some number of lines (e.g., /Page/-5). 

%rexp% This argument is the same as /rexp/ ', except that no file is created for 
the section. 

Inno A file is to be created from the current line up to (but not including) 
Inno. The current line becomes Inno. 

{num} Repeat argument. This argument may follow any of the above argu- 
ments. If it follows a rexp type argument, that argument is applied 
num more times. If it follows Inno, the file will be split every Inno 
lines (num. times) from that point. 

Enclose all rexp type arguments that contain blanks or other characters meaningful to 
the shell in the appropriate quotes. Regular expressions may not contain embedded 
new-lines, csplit does not affect the original file; it is the users responsibility to 
remove it. 

csplit -f cobol file '/procedure division/ 7 /par5./ /parl6./ 

This example creates four files, cobolOO . . . cobolOS. After editing the "split" files, 
they can be recombined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file. 
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SEE ALSO 
DIAGNOSTICS 



csplit-kfile 100 {99} 

This example would split the file at every 100 lines, up to 10,000 lines. The -k option 
causes the created files to be retained if there are less than 10,000 lines; however, an 
error message would still be printed. 

csplit-kprog.c '%main(%' 7 A }/+1' {20} 

Assuming that prog.c follows the normal C coding convention of ending routines 
with a } at the beginning of the line, this example will create a file containing each 
separate C routine (up to 21) in prog.c. 

ed(l), sh(l), regexp(5). 

Self-explanatory except for: 

arg - out of range 
which means that the given argument did not reference a line between the current 
position and the end of the file. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
BUGS 



CT(1C) 



ct - spawn getty to a remote terminal 

ct [ -wn ] [ -xn ] [ -h ] [ -v ] [ -sspeed ] telno ... 

ct dials the telephone number of a modem that is attached to a terminal, and spawns 
a getty process to that terminal. Telno is a telephone number, with equal signs for 
secondary dial tones and minus signs for delays at appropriate places. (The set of 
legal characters for telno is thru 9, -, =, *, and #. The maximum length telno is 31 
characters). If more than one telephone number is specified, ct will try each in suc- 
cession until one answers; this is useful for specifying alternate dialing paths. 

ct will try each line listed in the file /usr/lib/uucp/Devices until it finds an available 
line with appropriate attributes or runs out of entries. If there are no free lines, ct 
will ask if it should wait for one, and if so, for how many minutes it should wait 
before it gives up. ct will continue to try to open the dialers at one-minute intervals 
until the specified limit is exceeded. The dialogue may be overridden by specifying 
the -wn option, where n is the maximum number of minutes that ct is to wait for a 
line. 

The -xn option is used for debugging; it produces a detailed output of the program 
execution on stderr. The debugging level, n, is a single digit; -x9 is the most useful 
value. 

Normally, ct will hang up the current line, so the line can answer the incoming call. 
The -h option will prevent this action. The -h option will also wait for the termina- 
tion of the specified ct process before returning control to the user's terminal. If the 
-v option is used, ct will send a running narrative to the standard error output 
stream. 

The data rate may be set with the -s option, where speed, is expressed in baud. The 
default rate is 1200. 

After the user on the destination terminal logs out, there are two things that could 
occur depending on what type of getty is on the line (getty or uugetty). For the first 
case, ct prompts, Reconnect? If the response begins with the letter n, the line will be 
dropped; otherwise, getty will be started again and the login: prompt will be 
printed. In the second case, there is already a getty (uugetty) on the line, so the login: 
message will appear. 

To log out properly, the user must type control D. 

Of course, the destination terminal must be attached to a modem that can answer the 
telephone. 

/usr/lib/uucp/Devices 
/usr/adm/ctlog 

cu(lC), getty(lM), login(l), uucp(lC). uugetty(lM). 

For a shared port, one used for both dial-in and dial-out, the uugetty program run- 
ning on the line must have the -r option specified (see uugetty (IM)). 
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NAME 

SYNOPSIS 

DESCRIPTION 



CTAGS(1) 



ctags - create a tags file 

ctags [ -BFatuwvx ] [ -f tagsfile ] name ... 

Ctags makes a tags file for ex(l) from the specified C, Pascal, Fortran, YACC, lex, and 
lisp sources. A tags file gives the locations of specified objects (in this case functions 
and typedefs) in a group of files. Each line of the tags file contains the object name, 
the file in which it is defined, and an address specification for the object definition. 
Functions are searched with a pattern, typedefs with a line number. Specifiers are 
given in separate fields on the line, separated by blanks or tabs. Using the tags file, ex 
can quickly find these objects definitions. 

If the -x flag is given, ctags produces a list of object names, the line number and file 
name on which each is defined, as well as the text of that line and prints this on the 
standard output. This is a simple index which can be printed out as an off-line read- 
able function index. 

If the -v flag is given, an index of the form expected by vgrind(l) is produced on the 
standard output. This listing contains the function name, file name, and page 
number (assuming 64 line pages). Since the output will be sorted into lexicographic 
order, it may be desired to run the output through sort -f . Sample use: 

ctags -v files I sort -f > index 

vgrind -x index 

Normally ctags places the tag descriptions in a file called tags; this may be overridden 
with the -f option. 

Files whose names end in .c or .h are assumed to be C source files and are searched 
for C routine and macro definitions. Files whose names end in .y are assumed to be 
YACC source files. Files whose names end in .1 are assumed to be either lisp files if 
their first non-blank character is ';', '(', or '[', or lex files otherwise. Other files are 
first examined to see if they contain any Pascal or Fortran routine definitions; if not, 
they are processed again looking for C definitions. 

Other options are: 

-F 

-B 

-a 

-t 

-w 

-u 



use forward searching patterns (/.../) (default). 

use backward searching patterns (?...?). 

append to tags file. 

create tags for typedefs. 

suppressing warning diagnostics. 

causing the specified files to be updated in tags, that is, all references to them are 
deleted, and the new values are appended to the file. (Beware: this option is 
implemented in a way which is rather slow; it is usually faster to simply 
rebuild the tags file.) 

The tag main is treated specially in C programs. The tag formed is created by 
prepending M to the name of the file, with a trailing .c removed, if any, and leading 
pathname components also removed. This makes use of ctags practical in directories 
with more than one program. 



FILES 



tags 



output tags file 
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SEE ALSO 

ex(l),vi(l) 

AUTHOR 

Ken Arnold; FORTRAN added by Jim Kleckner; Bill Joy added Pascal and -x, replac- 
ing cxref; C typedefs added by Ed Pelegri-Llopart. 

BUGS 

Recognition of functions, subroutines and procedures for FORTRAN and Pascal is 
done is a very simpleminded way. No attempt is made to deal with block structure; 
if you have two Pascal procedures in different blocks with the same name you lose. 

The method of deciding whether to look for C or Pascal and FORTRAN functions is a 
hack. 

Does not know about #ifdefs. 

Should know about Pascal types. Relies on the input being well formed to detect 
typedefs. Use of -tx shows only the last line of typedefs. 
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NAME 
SYNOPSIS 



cu - call another UNIX system 



cu [-sspeed] [-lline] [-h] [-t] [-d] [-o I -e] [-n] telno 
cu [ -s speed ] [ -h ] [ -d ] [ -o I -e ] -1 line 
cu [-h] [~d] [-o I -e] systemname 

DESCRIPTION 

cu calls up another UNIX system, a terminal, or possibly a non-UNIX system. It 
manages an interactive conversation with possible transfers of ASCII files. 

cu accepts the following options and arguments: 

-sspeed Specifies the transmission speed (300, 1200, 2400, 4800, 9600); The 

default value is "Any" speed which will depend on the order of the 
lines in the /usr/lib/uucp/Devices file. Most modems are either 300 or 
1200 baud. Directly connected lines may be set to a speed higher than 
1200 baud. 

-lline Specifies a device name to use as the communication line. This can be 

used to override the search that would otherwise take place for the first 
available line having the right speed. When the -1 option is used 
without the -s option, the speed of a line is taken from the Devices file. 
When the -1 and -s options are both used together, cu will search the 
Devices file to check if the requested speed for the requested line is 
available. If so, the connection will be made at the requested speed; oth- 
erwise an error message will be printed and the call will not be made. 
The specified device is generally a directly connected asynchronous line 
(e.g., /dev/ttyab) in which case a telephone number (telno) is not 
required. The specified device need not be in the /dev directory. If the 
specified device is associated with an auto dialer, a telephone number 
must be provided. Use of this option with systemname rather than telno 
will not give the desired result (see systemname below). 

-h Emulates local echo, supporting calls to other computer systems which 

expect terminals to be set to half -duplex mode. 

-t Used to dial an ASCII terminal which has been set to auto answer. 

Appropriate mapping of carriage-return to carriage-return-line-feed 
pairs is set. 

-d Causes diagnostic traces to be printed. 

-o Designates that odd parity is to be generated for data sent to the remote 

system. 

-n For added security, will prompt the user to provide the telephone 

number to be dialed rather than taking it from the command line. 

-e Designates that even parity is to be generated for data sent to the 

remote system. 

telno When using an automatic dialer, the argument is the telephone number 

with equal signs for secondary dial tone or minus signs placed 
appropriately for delays of 4 seconds. 

systemname A uucp system name may be used rather than a telephone number; in 
this case, cu will obtain an appropriate direct line or telephone number 
from /usr/lib/uucp/Systems. Note: the systemname option should not be 
used in conjunction with the -1 and -s options as cu will connect to the 
first available line for the system name specified, ignoring the requested 
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line and speed. 

After making the connection, cu runs as two processes: the transmit process reads 
data from the standard input and, except for lines beginning with ~, passes it to the 
remote system; the receive process accepts data from the remote system and, except 
for lines beginning with ~, passes it to the standard output. Normally, an automatic 
DC3/DC1 protocol is used to control input from the remote so the buffer is not over- 
run. Lines beginning with ~ have special meanings. 

The transmit process interprets the following user initiated commands: 

~. terminate the conversation. 



~! 

~\cm&... 
~%cmd . . . 
~%cd 

~%take from [ to ] 
~%put from [ to ] 



escape to an interactive shell on the local system. 

run cmd on the local system (via sh -c). 

run cmd locally and send its output to the remote system. 

change the directory on the local system. Note: ~!cd will 
cause the command to be run by a sub-shell, probably not 
what was intended. 

copy file from (on the remote system) to file to on the local sys- 
tem. If to is omitted, the from argument is used in both places. 

copy file from (on local system) to file to on remote system. If 
to is omitted, the from argument is used in both places. 

For both ~%take and put commands, as each block of the file 
is transferred, consecutive single digits are printed to the ter- 
minal. 

— line send the line ~ line to the remote system. 

~% break transmit a BREAK to the remote system (which can also be 

specified as ~%b). 

~% debug toggles the -d debugging option on or off (which can also be 

specified as ~%d). 

~t prints the values of the termio structure variables for the 

user's terminal (useful for debugging). 

~1 prints the values of the termio structure variables for the 

remote communication line (useful for debugging). 

~%nostop t°ggl es between DC3/DC1 input control protocol and no input 

control. This is useful in case the remote system is one which 
does not respond properly to the DCS and DC1 characters. 

The receive process normally copies data from the remote system to its standard out- 
put. Internally the program accomplishes this by initiating an output diversion to a 
file when a line from the remote begins with ~. 

Data from the remote is diverted (or appended, if » is used) to file on the local sys- 
tem. The trailing ~> marks the end of the diversion. 

The use of ~%put requires sttyd) and cat (I) on the remote side. It also requires that 
the current erase and kill characters on the remote system be identical to these 
current control characters on the local system. Backslashes are inserted at appropri- 
ate places. 
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The use of ~%take requires the existence of echo(l) and cat (1) on the remote system. 
Also, tabs mode (See stty(D) should be set on the remote system if tabs are to be 
copied without expansion to spaces. 

When cu is used on system X to connect to system Y and subsequently used on sys- 
tem Y to connect to system Z, commands on system Y can be executed by using 
Executing a tilde command reminds the user of the local system uname. For exam- 
ple, uname can be executed on Z, X, and Y as follows: 



EXAMPLES 



FILES 

SEE ALSO 

DIAGNOSTICS 

WARNINGS 



uname 

Z 

-[X]! uname 

X 

— [Y]!uname 

Y 

In general, ~ causes the command to be executed on the original machine, — causes 
the command to be executed on the next machine in the chain. 

To dial a system whose telephone number is 9 201 555 1212 using 1200 baud (where 
dialtone is expected after the 9): 

cu -sl200 9=12015551212 
If the speed is not specified, "Any" is the default value. 
To login to a system connected by a direct line: 

cu -1 /dev/ttyXX 
or 

cu-lttyXX 
To dial a system with the specific line and a specific speed: 

cu -sl200 -1 ttyXX 
To dial a system using a specific line associated with an auto dialer: 

cu -1 culXX 9=12015551212 
To use a system name: 

cu systemname 

/usr/lib/uucp/Systems 
/usr/lib/uucp/Devices 
/usr/spool/locks/LCK..(tty-device) 

cat(l), ct(lC), echo(l), stty(l), uucp(lC), uname(l). 

Exit code is zero for normal exit, otherwise, one. 

The cu command does not do any integrity checking on data it transfers. Data fields 
with special cu characters may not be transmitted properly. Depending on the inter- 
connection hardware, it may be necessary to use a ~. to terminate the conversion 
even if stty has been used. Non-printing characters are not dependably transmitted 
using either the ~%put or ~%take commands, cu between an IMBR1 and a penril 
modem will not return a login prompt immediately upon connection. A carriage 
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return will return the prompt. I 

BUGS 

There is an artificial slowing of transmission by cu during the ~%put operation so 
that loss of data is unlikely. 
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NAME 
SYNOPSIS 

DESCRIPTION 



EXAMPLES 



DIAGNOSTICS 



CUT(1) 



cut - cut out selected fields of each line of a file 

cut-clist [file ...] 

cut -f list [-dchar] [-s] [file ...] 

Use cut to cut out columns from a table or fields from each line of a file; in data base 
parlance, it implements the projection of a relation. The fields as specified by list can 
be fixed length, i.e., character positions as on a punched card (-c option) or the length 
can vary from line to line and be marked with a field delimiter character like tab (-f 
option), cut can be used as a filter; if no files are given, the standard input is used. In 
addition, a file name of "-" explicitly refers to standard input. 

The meanings of the options are: 

list A comma-separated list of integer field numbers (in increasing order), with 

optional - to indicate ranges [e.g., 1,4,7; 1-3,8; -5,10 (short for 1-5,10); or 3- 
(short for third through last field)]. 

-clist The list following -c (no space) specifies character positions (e.g., -cl-72 
would pass the first 72 characters of each line). 

-Hist The list following -f is a list of fields assumed to be separated in the file by a 
delimiter character (see -d ); e.g., -f 1,7 copies the first and seventh field only. 
Lines with no field delimiters will be passed through intact (useful for table 
subheadings), unless -s is specified. 

-dchar The character following -d is the field delimiter (-f option only). Default is 
tab. Space or other characters with special meaning to the shell must be 
quoted. 

-s Suppresses lines with no delimiter characters in case of -f option. Unless 

specified, lines with no delimiters will be passed through untouched. 

Either the -c or -f option must be specified. 

Use grep(l) to make horizontal "cuts" (by context) through a file, or paste{\) to put 
files together column-wise (i.e., horizontally). To reorder columns in a table, use cut 
and paste. 

cut -d: -f 1,5 /etc/passwd mapping of user IDs to names 

name= s who am i I cut -fl -d" " s to set name to current login name. 



ERROR: line too long 

A line can have no more than 1023 characters or fields, or there is 
no new-line character. 

ERROR: bad list for c If option 

Missing -c or -f option or incorrectly specified list . No error 
occurs if a line has fewer fields than the list calls for. 

ERROR: no fields The list is empty. 

ERROR: no delimeter 

Missing char on -d option. 

ERROR: cannot handle multiple adjacent backspaces 

Adjacent backspaces cannot be processed correctly. 
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WARNING: cannot open <filename> m 

Either filename cannot be read or does not exist. If multiple V. 

filenames are present, processing continues. 

SEE ALSO 

grep(l), pasted). 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLE 



DIAGNOSTICS 



DATE(1) 



date - print and set the date 

date [ mmddhhmm[yy] ] I +format ] 

If no argument is given, or if the argument begins with +, the current date and time 
are printed. Otherwise, the current date is set. The first mm is the month number; dd 
is the day number in the month; hh is the hour number (24 hour system); the second 
mm is the minute number; yy is the last 2 digits of the year number and is optional. 
For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the default if no year is men- 
tioned. The system operates in GMT. date takes care of the conversion to and from 
local standard and daylight time. Only the superuser may change the date. 

If the argument begins with +, the output of date is under the control of the user. All 
output fields are of fixed size (zero padded if necessary). Each field descriptor is pre- 
ceded by % and will be replaced in the output by its corresponding value. A single 
% is encoded by %%. All other characters are copied to the output without change. 
The string is always terminated with a new-line character. 

Field Descriptors: 

n insert a new-line character 

t insert a tab character 

m month of year - 01 to 12 

d day of month - 01 to 31 

y last 2 digits of year - 00 to 99 

D date as mm/dd/yy 

H hour - 00 to 23 

M minute - 00 to 59 

S second - 00 to 59 

T time as HH:MM:SS 

j day of year - 001 to 366 

w day of week - Sunday = 

a abbreviated weekday - Sun to Sat 

h abbreviated month - Jan to Dec 

r time in AM/PM notation 

date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 
would have generated as output: 
DATE: 08/01/76 
TIME: 14:45:05 

No permission if you are not the super-user and you try to change the date; 

bad conversion if the date set is syntactically incorrect; 

bad format character if the field descriptor is not recognizable. 
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NAME 

dbg -debugger 

dbg [a.outfile] [corefile] 

The dbg command calls the debugger. It can be used with C and Fortran programs to 
examine their object files and core files and to provide a controlled environment for 
their execution. 

a.outfile defaults to a.out which is produced by compilation or link editing. This may 
be changed to reflect your own file name, corefile defaults to core and may be 
changed to another corefile name. 

a.out 
core 



c 



FILES 



SEE ALSO 

cc(l), a.out(4), core(4), sh(l), syms(4) 
The Programmer's Guide. 
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NAME 

SYNOPSIS 

DESCRIPTION 



DC(1) 



dc - desk calculator 



dc [ file ] 



dc is an arbitrary precision arithmetic package. Ordinarily it operates on decimal 
integers, but one may specify an input base, output base, and a number of fractional 
digits to be maintained. (See bed), a preprocessor for dc that provides infix notation 
and a C-like syntax that implements functions. Be also provides reasonable control 
structures for programs.) The overall structure of dc is a stacking (reverse Polish) cal- 
culator. If an argument is given, input is taken from that file until its end, then from 
the standard input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an unbroken 
string of the digits 0-9. It may be preceded by an underscore (_) to input a 
negative number. Numbers may contain decimal points. 



+ -/* 



sx 



Ix 



p 
p 
f 

q 

Q 



x 



] 



The top two values on the stack are added (+), subtracted (-), multiplied (*), 
divided (/), remaindered (%), or exponentiated ( A ). The two entries are 
popped off the stack; the result is pushed on the stack in their place. Any frac- 
tional part of an exponent is ignored. 

The top of the stack is popped and stored into a register named x, where x 
may be any character. If the s is capitalized, x is treated as a stack and the 
value is pushed on it. 

The value in register x is pushed on the stack. The register x is not altered. 
All registers start with zero value. If the 1 is capitalized, register x is treated as 
a stack and its top value is popped onto the main stack. 

The top value on the stack is duplicated. 

The top value on the stack is printed. The top value remains unchanged. 

Interprets the top of the stack as an ASCII string, removes it, and prints it. 

All values on the stack are printed. 

Exits the program. If executing a string, the recursion level is popped by two. 

Exits the program. The top Vctlue on the stack is popped and the string execu- 
tion level is popped by that value. 

Treats the top element of the stack as a character string and executes it as a 
string of dc commands. 

Replaces the number on the top of the stack with its scale factor. 

Puts the bracketed ASCII string onto the top of the stack. 



<x >x =x 

The top two elements of the stack are popped and compared. Register x is 
evaluated if they obey the stated relation. 

v Replaces the top element on the stack by its square root. Any existing frac- 
tional part of the argument is taken into account, but otherwise the scale factor 
is ignored. 

! Interprets the rest of the line as a UNIX system command. 
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EXAMPLE 



SEE ALSO 
DIAGNOSTICS 



O 

k 



z 
Z 

7 



DC(1) 



All values on the stack are popped. 

The top value on the stack is popped and used as the number radix for further 
input. I Pushes the input base on the top of the stack. 

The top value on the stack is popped and used as the number radix for further 
output. 

Pushes the output base on the top of the stack. 

The top of the stack is popped, and that value is used as a non-negative scale 
factor: the appropriate number of places are printed on output, and main- 
tained during multiplication, division, and exponentiation. The interaction of 
scale factor, input base, and output base will be reasonable if all are changed 
together. 

The stack level is pushed onto the stack. 

Replaces the number on the top of the stack with its length. 

A line of input is taken from the input source (usually the terminal) and exe- 
cuted. 

are used by be (I) for array operations. 



This example prints the first ten values of n!: 

[lal +dsa* plal 0>y ] sy 

Osal 

lyx 

bed). 

x is unimplemented 

where x is an octal number. 

stack empty 

for not enough elements on the stack to do what was asked. 

Out of space 

when the free list is exhausted (too many digits). 

Out of headers 

for too many numbers being kept around. 

Out of pushdown 

for too many items on the stack. 

Nesting Depth 

for too many levels of nested execution. 
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NAME 

SYNOPSIS 

DESCRIPTION 



dd - convert and copy a file 



dd [option= value] ... 



dd copies the specified input file to the specified output with possible conversions. 
The standard input and output are used by default. The input and output block size 
may be specified to take advantage of raw physical I/O. 



option 
i(=file 
o£=file 
ibs=n 
obs=n 
bs=n 



cbs=n 

skip=n 

seek=n 

count=n 

conv=ascii 



values 

input file name; standard input is default 

output file name; standard output is default 

input block size n bytes (default 512) 

output block size (default 512) 

set both input and output block size, superseding ibs and obs; also, if 

no conversion is specified, it is particularly efficient since no in-core 

copy need be done 

conversion buffer size 

skip n input blocks before starting copy 

seek n blocks from beginning of output file before copying 

copy only n input blocks 

convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
block convert variable length records to fixed length 
unblock 

convert fixed length records to variable length 

map alphabetics to lower case 

map alphabetics to upper case 

swap every pair of bytes 
noerror 

do not stop processing on an error 
sync pad every input block to ibs 
....... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may end with k, 
b, or w to specify multiplication by 1024, 512, or 2, respectively; a pair of numbers 
may be separated by x to indicate multiplication. 

cbs is used only if conv=ascii, conv=unblock , conv=ebcdic, or conv=block is specified. In 
the first two cases, cbs characters are placed into the conversion buffer (converted to 
ASCII). Trailing blanks are trimmed and a new-line added before sending the line to 
the output. In the latter two cases, ASCII characters are read into the conversion 
buffer (converted to EBCDIC). Blanks are added to make up an output block of size 
cbs. 

After completion, dd reports the number of whole and partial input and output 
blocks. 



lease 
ucase 
swab 



DIAGNOSTICS 



f+p blocks in(out) 



numbers of full and partial blocks read(written) 
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NAME 



SYNOPSIS 
DESCRIPTION 



delta - make a delta (change) to an SCCS file 

delta [-rSID] [-s] [-n] [-glist] [-m[mrlist]] [-y[comment]] [-p] files 

delta is used to permanently introduce into the named SCCS file changes that were 
made to the file retrieved by get (1) (called the g-file, or generated file). 

delta makes a delta to each named SCCS file. If a directory is named, delta behaves as 
though each file in the directory were specified as a named file, except that non-SCCS 
files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read (see WARN- 
INGS); each line of the standard input is taken to be the name of an SCCS file to be 
processed. 

delta may issue prompts on the standard output depending upon certain keyletters 
specified and flags [see admind)] that may be present in the SCCS file (see -m and -y 
keyletters below). 

Keyletter arguments apply independently to each named file. 

-rSID Uniquely identifies which delta is to be made to the SCCS file. 

The use of this keyletter is necessary only if two or more out- 
standing gets for editing (get -e) on the same SCCS file were 
done by the same person (login name). The SID value 
specified with the -r keyletter can be either the SID specified 
on the get command line or the SID to be made as reported by 
the get command [see get(l)]. A diagnostic results if the 
specified SID is ambiguous, or, if necessary and omitted on the 
command line. 

-s Suppresses the issue, on the standard output, of the created 

delta's SID, as well as the number of lines inserted, deleted and 
unchanged in the SCCS file. 

~n Specifies retention of the edited g-file (normally removed at 

completion of delta processing). 

-glist a list (see get(l) for the definition of list) of deltas which are to 

be ignored when the file is accessed at the change level (SID) 
created by this delta. 

-m[mrlist] If the SCCS file has the v flag set [see admin(D] then a 

Modification Request (MR) number must be supplied as the 
reason for creating the new delta. 

If -m is not used and the standard input is a terminal, the 
prompt MRs? is issued on the standard output before the stan- 
dard input is read; if the standard input is not a terminal, no 
prompt is issued. The MRs? prompt always precedes the com- 
ments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. 
An unescaped new-line character terminates the MR list. 

Note that if the v flag has a value [see admin(D], it is taken to 
be the name of a program (or shell procedure) which will vali- 
date the correctness of the MR numbers. If a non-zero exit 
status is returned from the MR number validation program, 
delta terminates. (It is assumed that the MR numbers were not 
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DELTA(1) 



DELTA (1) 



FILES 



WARNINGS 



SEE ALSO 
DIAGNOSTICS 



all valid.) 

-ylcornment] Arbitrary text used to describe the reason for making the 
delta. A null string is considered a valid comment. 

If -y is not specified and the standard input is a terminal, the 
prompt comments? is issued on the standard output before 
the standard input is read; if the standard input is not a termi- 
nal, no prompt is issued. An unescaped new-line character 
terminates the comment text. 

-p Causes delta to print (on the standard output) the SCCS file 

differences before and after the delta is applied in a diff{\) for- 
mat. 

g-file Existed before the execution of delta; removed after completion of 

delta. 
p-file Existed before the execution of delta; may exist after completion of 

delta . 
q-file Created during the execution of delta; removed after completion of 

delta . 
x-file Created during the execution of delta; renamed to SCCS file after 

completion of delta . 
z-file Created during the execution of delta; removed during the execution 

of delta . 
d-file Created during the execution of delta; removed after completion of 

delta . 
/usr/bin/bdiff Program to compute differences between the "gotten" file and the 

g-file. 

Lines beginning with an SOH ASCII character (binary 001) cannot be placed in the 
SCCS file unless the SOH is escaped. This character has special meaning to SCCS [see 
sccsfile(4d (5)] and will cause an error. 

A get of many SCCS files, followed by a delta of those files, should be avoided when 
the get generates a large amount of data. Instead, multiple get/delta sequences should 
be used. 

If the standard input (-) is specified on the delta command line, the -m (if necessary) 
and -y keyletters must also be present. Omission of these keyletters causes an error 
to occur. 

Comments are limited to text strings of at most 512 characters. 
admin(l),bdiff(l), cdc(l), get(l), help(l), prs(l), rmdel(l), sccsfile(4). 
Use help (I) for explanations. 
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DER0FF(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



DER0FF(1) 



deroff - remove nroff /troff, tbl, and eqn constructs 

deroff [-mx] [-w] [ files ] 

deroff reads each of the files in sequence and removes all troff (1) requests, macro calls, 
backslash constructs, eqn(l) constructs (between .EQ and .EN lines, and between del- 
imiters), and tbl(l) descriptions, perhaps replacing them with white space (blanks 
and blank lines), and writes the remainder of the file on the standard output, deroff 
follows chains of included files (.so and .nx troff commands); if a file has already been 
included, a .so naming that file is ignored and a .nx naming that file terminates exe- 
cution. If no input file is given, deroff reads the standard input. 

The -m option may be followed by an m, s, or 1. The -mm option causes the macros 
to be interpreted so that only running text is output (i.e., no text from macro lines.) 
The -ml option forces the -mm option and also causes deletion of lists associated 
with the mm macros. 

If the -w option is given, the output is a word list, one "word" per line, with all other 
characters deleted. Otherwise, the output follows the original, with the deletions 
mentioned above. In text, a "word" is any string that contains at least two letters and 
is composed of letters, digits, ampersands (&), and apostrophes ('); in a macro call, 
however, a "word" is a string that begins with at least two letters and contains a total 
of at least three letters. Delimiters are any characters other than letters, digits, apos- 
trophes, and ampersands. Trailing apostrophes and ampersands are removed from 
"words." 

eqn(l), nroff(l), tbl(l), troff(l). 

deroff is not a complete troff interpreter, so it can be confused by subtle constructs. 
Most such errors result in too much rather than too little output. 
The -ml option does not handle nested lists correctly. 
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DEVNM(1M) 



NAME 

SYNOPSIS 

DESCRIPTION 

EXAMPLE 



FILES 



devnm - device name 

/etc/devnm [ names ] 

devnm identifies the special file associated with the mounted file system where the 
argument name resides. 

The command: 

/etc/devnm /usr 
produces 

/dev/dsk/cld0s2 usr 
if /usr is mounted on /dev/dsk/cld0s2. 

/dev/dsk/* 
/etc/mnttab 
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NAME 

SYNOPSIS 

DESCRIPTION 



NOTE 



FILES 



DF(1M) 



df - report number of free disk blocks and i-nodes 

df [-It] [-f] [-b] [file-system I directory I mounted-resource] 

The df command prints out the number of free blocks and free i-nodes in mounted 
file systems, directories, or mounted resources by examining the counts kept in the 
super-blocks. 

file-system may be specified either by device name (e.g., /dev/dsk/cld0s2) or by 
mount point directory name (e.g., /usr). 

directory can be a directory name. The report presents information for the device that 
contains the directory. 

mounted-resource can be a remote resource name. The report presents information for 
the remote device that contains the resource. 

If no arguments are used, the free space on all locally and remotely mounted file sys- 
tems is printed. 

The df command uses the following options: 

-1 

~t 

-f 
-b 



only reports on local file systems. 

causes the figures for total allocated blocks and i-nodes to be reported as well 
as the free blocks and i-nodes. 

an actual count of the blocks in the free list is made, rather than taking the 
figure from the super-block (free i-nodes are not reported). This option will not 
print any information about mounted remote resources. 

produce output in 4.3BSD format. 



( 



( 



SEE ALSO 



If multiple remote resources are listed that reside on the same file system on a remote 
machine, each listing after the first one will be marked with an asterisk. 

/dev/dsk/* 
/etc/mnttab 

fs(4), mnttab(4), mount(lM). 
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NAME 
SYNOPSIS 

DESCRIPTION 



DFCONF (1M) 



dfconf, dflist, dfreset - disk farms and administration 

df conf [ -c ] ctrldev sees cnt dev ... 
dflist dev [ dev ... ] 
dfreset ctrldev [ ctrldev ... ] 

Disk farming allows one or more disk partitions on one or more disk drives to be 
combined into one logical disk partition. Each disk farm is represented by three dev- 
ices: a block access device (found in /dev/farm), a raw access device (found in 
/dev/rfarm), and a controlling device (found in /dev/farmctrl). The controlling device is 
used when configuring, resetting, or listing a farm; the raw access device can also be 
used to list the farm. Once configured, the block and raw devices behave as any- 
other disk device. 

Each disk partition in the farm is divided into one or more equal sized groups of logi- 
cally consecutive sectors called leaves. A farm is arranged such that sectors through 
N-l map to the th leaf of the first partition, sectors N through 2N-1 map to the l 
leaf of the second partition, etc., each disk in turn contributing the next block of N 
sectors. Each partition contributes the same number of leaves, and all leaves are the 
same number of sectors. 

dfconf configures a disk farm for use. If -c is the first argument, the disk farm 
configuration will be listed after a successful completion, ctrldev must be the 
/dev/farmctrl corresponding to the farm to be configured, sees is how many sectors 
(NBPSCTR bytes per sector) in a leaf. The only logical constraint on this number is 
that the number of bytes in a leaf must be a multiple of the access size. For example, 
if the farm will be read and written in 4Kbyte pieces, sees must be a multiple of 
(4K/NBPSCTR). cnt is the total number of leaves contributed by each partition. The 
remaining arguments are the block special device file(s) which make up the farm. 

N.B. No checking is done during configuration, so it is possible to have a successful 
configuration and not be able to use the farm. 

dfreset clears the state of the named farm(s), as in preparation for system shutdown or 
to reconfigure a farm. The specified device(s) must be the /dev/farmctrl corresponding 
to the farm to be reset. If the farm is currently open by a process or mounted, the 
reset will fail. 

dflist lists the configuration for the named farm(s). The specified device(s) may be 
either the corresponding /dev/farmctrl entry or the appropriate /dev/rfarm character 
special file. 

Both dfconf and dfreset may only be invoked by the super user, dflist may be invoked 
by any user, provided they also have read /write permission for the necessary farm 
device(s). 
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NAfJIE 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

WARNINGS 



DIFF(1) 



diff - differential file comparator 

diff [-efbh] filel file2 

diff tells what lines must be changed in two files to bring them into agreement. If 
filel {file!) is -, the standard input is used. If filel {file!) is a directory, then a file in 
that directory with the name filel {.filel ) is used. The normal output contains lines of 
these forms: 

nl an3,n4 
nl,nldn3 
nl,n2 cn3,n4 

These lines resemble ed commands to convert filel into filel. The numbers after the 
letters pertain to filel. In fact, by exchanging a for d and reading backward one may 
ascertain equally how to convert filel into filel . As in ed, identical pairs, where nl = 
nl or n3 = n4, are abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file 
flagged by <, then all the lines that are affected in the second file flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored and other strings 
of blanks to compare equal. 

The -e option produces a script of a, c, and d commands for the editor ed, which will 
recreate filel horn filel . The -f option produces a similar script, not useful with ed, in 
the opposite order. In connection with -e, the following shell program may help 
maintain multiple versions of a file. Only an ancestral file ($1) and a chain of 
version-to- version ed scripts ($2,$3,...) made by diff need be on hand. A "latest ver- 
sion" appears on the standard output. 

(shift; cat $*; echo 'l,$p') I ed - $1 

Except in rare circumstances, diff finds a smallest sufficient set of file differences. 

Option -h does a fast, half-hearted job. It works only when changed stretches are 
short and well separated, but does work on files of unlimited length. Options -e and 
-f are unavailable with -h. 

/tmp/d????? 
/usr/lib/diffh for -h 

bdiff(l), cmp(l), comm(l), ed(l). 

Exit status is for no differences, 1 for some differences, 2 for trouble. 

Editing scripts produced under the -e or -f option are naive about creating lines con- 
sisting of a single period (.). 

Missing newline at end of file X 

indicates that the last line of file X did not have a new-line. If the lines are different, 
they will be flagged and output; although the output will seem to indicate they are 
the same. 
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DIFF(1B) 

NAME 
SYNOPSIS 

DESCRIPTION 



DIFF(1B) 



diff - differential file and directory comparator 

dif f [ -1 ] [ -r ] [ -s ] [ -cef hn ] [ -biwt ] dirl dir2 
diff [ -cef hn ] [ -biwt ] filel file2 
diff [ -Dstring ] [ -biw ] filel file2 

If both arguments are directories, diff sorts the contents of the directories by name, 
and then runs the regular file diff algorithm (described below) on text files which are 
different. Binary files which differ, common subdirectories, and files which appear in 
only one directory are listed. Options when comparing directories are: 

-1 long output format; each text file diff is piped through pr(l) to paginate it, other 
differences are remembered and summarized after all text file differences are 
reported. 

-r causes application of diff recursively to common subdirectories encountered. 

-s causes diff to report files which are the same, which are otherwise not men- 
tioned. 

-Sname 

starts a directory diff in the middle beginning with file name. 

When run on regular files, and when comparing text files which differ during direc- 
tory comparison, diff tells what lines must be changed in the files to bring them into 
agreement. Except in rare circumstances, diff finds a smallest sufficient set of file 
differences. If neither filel nor filel is a directory, then either may be given as '-', in 
which case the standard input is used. If filel is a directory, then a file in that direc- 
tory whose file-name is the same as the file-name of filel is used (and vice versa). 

There are several options for output format; the default output format contains lines 
of these forms: 

nl a n3,n4 
nl,ril d n3 
ril,ril c n3,n4 

These lines resemble ed commands to convert filel into filel. The numbers after the 
letters pertain to filel. In fact, by exchanging 'a' for 'd' and reading backward one 
may ascertain equally how to convert filel into filel . As in ed, identical pairs where 
nl =nl or n3 = n4 are abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file 
flagged by '<', then all the lines that are affected in the second file flagged by '>'. 

Except for -b, -w, -i or -t which may be given with any of the others, the following 

options are mutually exclusive: 

produces a script of a, c and d commands for the editor ed, which will 
recreate filel from filel . In connection with -e, the following shell program 
may help maintain multiple versions of a file. Only an ancestral file ($1) 
and a chain of version-to-version ed scripts ($2,$3,...) made by diff need be 
on hand. A latest version 7 appears on the standard output. 

(shift; cat $*; echo 'l,$p') I ed - $1 

Extra commands are added to the output when comparing directories with 
-e, so that the result is a sh(l) script for converting text files which are com- 
mon to the two directories from their state in dirl to their state in dirl. 
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-f 



-n 



-c 



DIFF(1B) 



produces a script similar to that of -e, not useful with ed, and in the oppo- 
site order. 

produces a script similar to that of -e, but in the opposite order and with a 
count of changed lines on each insert or delete command. This is the form 
used by rcsdiffd). 

produces a diff with lines of context. The default is to present 3 lines of 
context and may be changed, e.g to 10, by -clO. With -c the output format 
is modified slightly: the output beginning with identification of the files 
involved and their creation dates and then each change is separated by a 
line with a dozen *'s. The lines removed from filel are marked with - '; 
those added to filel are marked '+ '. Lines which are changed from one file 
to the other are marked in both files with with '! '. 



( 



FILES 



SEE ALSO 

DIAGNOSTICS 

BUGS 



-h 



-w 



-i 



-t 



Changes which lie within <context> lines of each other are grouped 
together on output. (This is a change from the previous "diff -c" but the 
resulting output is usually much easier to interpret.) 

does a fast, half-hearted job. It works only when changed stretches are 
short and well separated, but does work on files of unlimited length. 

-D string causes diff to create a merged version of filel and filel on the standard out- 
put, with G preprocessor controls included so that a compilation of the 
result without defining string is equivalent to compiling filel, while 
defining string will yield filel . 

-b causes trailing blanks (spaces and tabs) to be ignored, and other strings of 

blanks to compare equal. 

is similar to -b but causes whitespace (blanks and tabs) to be totally 
ignored. E.g., "if ( a == b )" will compare equal to "if(a==b)". 

ignores the case of letters. E.g., "A" will compare equal to "a". 

will expand tabs in output lines. Normal or -c output adds character(s) to 
the front of each line which may screw up the indentation of the original 
source lines and make the output listing difficult to interpret. This option 
will preserve the original source's indentation. 

/tmp/d????? 
/usr/lib/diffh for -h 
/bin/diff for directory diffs 
/bin/pr 

cmp(l), cc(l), comm(l), ed(l), diff3(l) 

Exit status is for no differences, 1 for some, 2 for trouble. 

Editing scripts produced under the -e or -f option are naive about creating lines con- 
sisting of a single 7. 

When comparing directories with the -b, -w or -i options specified, diff first compares 
the files ala cmp, and then decides to run the dz/f algorithm if they are not equal. This 
may cause a small amount of spurious output if the files then turn out to be identical 
because the only differences are insignificant blank string or case differences. 
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DiFF3(1) 



NAME 



SYNOPSIS 



DESCRIPTION 



FILES 



SEE ALSO 



BUGS 



diff3 - 3-way differential file comparison 

dif f3 [ -ex3 ] filel file2 file3 

diffi compares three versions of a file, and publishes disagreeing ranges of text 
flagged with these codes: 

===== all three files differ 

=====1 filel is different 

=====2 file2 is different 

=====3 file3 is different 

The type of change suffered in converting a given range of a given file to some other 
is indicated in one of these ways: 

/ : nl a Text is to be appended after line number nl in file /, where / 

= 1,2, or 3. 

f:nl,n2c Text is to be changed in the range line nl to line nl. If nl = 

nl, the range may be abbreviated to nl . 

The original contents of the range follows immediately after a c indication. When the 
contents of two files are identical, the contents of the lower-numbered file is 
suppressed. 

Under the -e option, diffi publishes a script for the editor ed that will incorporate 
into filel all changes between filel and file3, i.e., the changes that normally would be 
flagged ==== and ====3. Option -x (-3) produces a script to incorporate only 
changes flagged ==== (====3). The following command will apply the resulting 
script to filel . 

(cat script; echo 'l,$pO I ed - filel 

/tmp/d3* 
/usr/lib/diff3prog 

diff(l). 

Text lines that consist of a single . will defeat -e. 
Files longer than 64K bytes will not work. 
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SYNOPSIS 
DESCRIPTION 



DIRCMP(1) DIRCMP(1) 

NAME 

dircmp - directory comparison 

dircmp [ -d ] [ -s ] [ -wn ] dirl dir2 

dirctnp examines dirl and dirl and generates various tabulated information about the 
contents of the directories. Listings of files that are unique to each directory are gen- 
erated for all the options. If no option is entered, a list is output indicating whether 
the file names common to both directories have the same contents. 

-d Compare the contents of files with the same name in both directories and out- 
put a list telling what must be changed in the two files to bring them into agree- 
ment. The list format is described in diff{\). 

-s Suppress messages about identical files. 

-wn Change the width of the output line to n characters. The default width is 72. 

SEE ALSO 

cmp(l),diff(l). 
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FILES 
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DISKUSG(IM) 



diskusg - generate disk accounting data by user ID 

diskusg [options] [files] 

diskusg generates intermediate disk accounting information from data in files, or the 
standard input if omitted, diskusg output lines on the standard output, one per user, 
in the following format: uid login ttblocks 

where 

uid the numerical user ID of the user. 

login the login name of the user; and 

#blocks the total number of disk blocks allocated to this user. 

diskusg normally reads only the inodes of file systems for disk accounting. In this 
case, files are the special filenames of these devices. 

diskusg recognizes the following options: 

-s the input data is already in diskusg output format, diskusg combines all 

lines for a single user into a single line. 

-v verbose. Print a list on standard error of all files that are charged to no 

one. 

-i fnmlist ignore the data on those file systems whose file system name is in 
fnmlist. fnmlist is a list of file system names separated by commas or 
enclosed within quotes, diskusg compares each name in this list with 
the file system name stored in the volume ID (see labelit(lM)). 

-pfile use file as the name of the password file to generate login names. 

/etc/passwd is used by default. 

-u file write records to file of files that are charged to no one. Records consist 

of the special file name, the inode number, and the user ID. 

The output of diskusg is normally the input to acddisk (see acct(lM)) which generates 
total accounting records that can be merged with other accounting records, diskusg is 
normally run in dodisk (see acctsh(lM)). 

The following will generate daily disk accounting information for root on 
/dev/dsk/cldOsO: 

diskusg /dev/dsk/cldOsO I acctdisk > disktacct 



/etc/passwd 



used for user ID to login name conversions 



acct(lM), acct(4), acctsh(lM) 
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NAME 

SYNOPSIS 

DESCRIPTION 



BUGS 



DU(1M) 



du - summarize disk usage 

du [ -sar ] [ names ] 

du reports the number of 1024-byte logical blocks contained in all files and (recur- 
sively) directories within each directory and file specified by the names argument. 
The block count includes the indirect blocks of the file. If names is missing, the 
current directory is used. 

The optional arguments are as follows: 

-s causes only the grand total (for each of the specified names) to be given. 

-a causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is generated for each directory only. 

-r will cause du to generate messages about directories that cannot be be read, 
files that cannot be opened, etc., rather than being silent (the default). 

A file with two or more links is only counted once. 

If the -a option is not used, non-directories given as arguments are not listed. 

If there are links between files in different directories where the directories are on 

separate branches of the file system hierarchy, du will count the excess files more 

than once. 

Files with holes in them will get an incorrect block count. 
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DESCRIPTION 



SEE ALSO 



DVHTOOL(IM) 



dvhtool - modify disk volume header information 

/etc/dvhtool [ modify part nblks lstjblk type] [list] 

[-v [add unixjile dvhJleRcreat unixjile dvhjile] 

[delete dvhjile] [list]] 

[-d [modify name valueRlist]] 

[dvh_file -m partition_no filesysjype] 

dvhtool allows modification of the disk volume header information, where the disk 
volume header is a block located at the beginning of all disk media. The disk volume 
header consists of three main parts: the device parameters, the partition table, and 
the volume directory. The volume directory is used to locate such things as the boot 
block and the bad sector table. The partition table describes the logical device parti- 
tions. The device parameters describe the specifics of a particular disk drive. 

Invoked with no arguments, dvhtool allows the user to examine and modify the disk 
volume header interactively. The read command reads the volume header from the 
specified device. The vd, pt, and dp commands first list their respective portions of 
the volume header and then prompt for modifications. The write command writes 
the possibly modified volume header to the device. 

Invoked with arguments, dvhtool reads the volume header, performs the specified 
operations, and then writes the volume header. The following paragraphs describe 
dvhtool' s command line arguments. 

The -v flag provides four options for modifying the volume directory information in 
the disk volume header. The creat option allows creation of a volume directory with 
the name dvhjiame and the contents of unixjile. If an entry already exists with the 
name dvhjile, it is overwritten with the new contents. The add option adds a volume 
directory entry with the name dvhjle and the contents of unixjile. Unlike the creat 
option, the add options do not overwrite an existing entry. The delete option 
removes the entry named dvhjle, if it exists, from the volume directory. The list 
option lists the current volume directory contents. 

The -m flag allows dvhtool to invoke mkfs and make a file system of the type 
filesysjype (either 4K for System V or AFFS for Ardent Fast File System) on parti- 
tion partition_no on the drive named by dvhjSle. Mkfs will be invoked with 
default parameters which covers the entire partition. 

The -d flag provides two options for modifying the device parameter information in 
the disk volume header. The modify options sets the name device parameter to the 
specified valuefl . The list option lists the current device parameters. 

mkfs(lM) 
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DESCRIPTION 



SEE ALSO 
CAVEATS 



WARNING 



ECH0(1) 



echo - echo arguments 

/bin/echo [ arg ] ... 

echo writes its arguments separated by blanks and terminated by a new-line on the 
standard output. It also understands C-like escape conventions; beware of conflicts 
with the shell's use of \: 

\ b backspace 

\ c print line without new-line 
\f form-feed 
\ n new-line 
\r carriage return 
\t tab 
\v vertical tab 
\ \ backslash 

\ n where n is the 8-bit character whose ASCII code is the 1-, 2- or 3-digit octal 
number representing that character. 

echo is useful for producing diagnostics in command files and for sending known 
data into a pipe. 

sh(l),csh(l) 

When representing an 8-bit character by using the escape convention \0n, the n must 
always be preceded by the digit zero (0). 

For example, typing: echo "WARNINGA07' will print the phrase WARNING; and 
sound the "bell" on your terminal. The use of single (or double) quotes (or two 
backslashes) is required to protect the "\" that precedes the "017". 

For the octal equivalents of each character, see ascii(5). 

echo is a built-in command to both sh{\) and csh(l) and the syntax varies. 
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ed, red - text editor 

ed [-s] [-p string ] [-x] [file] 
red [-s] [-p string ] [-x] [file] 

ed is the standard text editor. If the file argument is given, ed simulates an e com- 
mand (see below) on the named file; that is to say, the file is read into ed's buffer so 
that it can be edited. 

-s Suppresses the printing of character counts by e, r, and w commands, of diag- 
nostics from e and q commands, and of the ! prompt after a Ishell command . 
Also, see the WARNING section at the end of this manual page. 

-p Allows the user to specify a prompt string. 

-x Encryption option; when this option is used, the file will be encrypted as it is 
being written and will require an encryption key to be read (see crypt(D). Also, 
see the WARNING section at the end of this manual page. 

ed operates on a copy of the file it is editing; changes made to the copy have no effect 
on the file until a w (write) command is given. The copy of the text being edited 
resides in a temporary file called the buffer. There is only one buffer. 

red is a restricted version of ed . It will only allow editing of files in the current direc- 
tory. It prohibits executing shell commands via Ishell command . Attempts to bypass 
these restrictions result in an error message {restricted shell). 

Both ed and red support the fspec(A) formatting capability. After including a format 
specification as the first line of file and invoking ed with your terminal in stty -tabs or 
stty tab3 mode (see stty (I)), the specified tab stops will automatically be used when 
scanning file. For example, if the first line of a file contained: <:t5,10,15 s72:> tab 
stops would be set at columns 5, 10, and 15, and a maximum line length of 72 would 
be imposed. NOTE: while inputing text, tab characters when typed are expanded to 
every eighth column as is the default. 

Commands to ed have a simple and regular structure: zero, one, or two addresses fol- 
lowed by a single-character command, possibly followed by parameters to that com- 
mand. These addresses specify one or more lines in the buffer. Every command that 
requires addresses has default addresses, so that the addresses can very often be 
omitted. 

In general, only one command may appear on a line. Certain commands allow the 
input of text. This text is placed in the appropriate place in the buffer. While ed is 
accepting text, it is said to be in input mode. In this mode, no commands are recog- 
nized; all input is merely collected. Input mode is left by typing a period (.) alone at 
the beginning of a line, followed immediately by a carriage return. 

ed supports a limited form of regular expression notation; regular expressions are used 
in addresses to specify lines and in some commands (e.g., s) to specify portions of a 
line that are to be substituted. A regular expression (RE) specifies a set of character 
strings. A member of this set of strings is said to be matched by the RE. The REs 
allowed by ed are constructed as follows: 

The following one-character REs match a single character: 

1.1 An ordinary character (not one of those discussed in 1.2 below) is a one- 
character RE that matches itself. 



Stardent 1500/3000 



143 



Essential Utilities 



ED(1) ED(1) 

1.2 A backslash (\) followed by any special character is a one-character RE that | 
matches the special character itself. The special characters are: ^ 

a. ., *, [, and \ (period, asterisk, left square bracket, and backslash, respec- 
tively), which are always special, except when they appear within square 
brackets ( [ ] ; see 1 .4 below). 

b. A (caret or circumflex), which is special at the beginning of an entire RE (see 
3.1 and 3.2 below), or when it immediately follows the left of a pair of 
square brackets ([]) (see 1.4 below). 

c. $ (dollar sign), which is special at the end of an entire RE (see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire RE, which is special for 
that RE (for example, see how slash (/) is used in the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character except new-line. 

1.4 A non-empty string of characters enclosed in square brackets ([]) is a one- 
character RE that matches any one character in that string. If, however, the first 
character of the string is a circumflex (A), the one-character RE matches any 
character except new-line and the remaining characters in the string. The A has 
this special meaning only if it occurs first in the string. The minus (-) may be 
used to indicate a range of consecutive ASCII characters; for example, [0-9] is 
equivalent to [0123456789]. The - loses this special meaning if it occurs first 
(after an initial A, if any) or last in the string. The right square bracket (]) does 
not terminate such a string when it is the first character within it (after an initial 
A, if any); e.g., []a-f] matches either a right square bracket (]) or one of the 
letters a through f inclusive. The four characters listed in 1.2.a above stand for 
themselves within such a string of characters. 

The following rules may be used to construct jREs from one-character REs: 

2.1 A one-character RE is a RE that matches whatever the one-character RE matches. 

2.2 A one-character RE followed by an asterisk (*) is a RE that matches zero or more 
occurrences of the one-character RE. If there is any choice, the longest leftmost 
string that permits a match is chosen. 

2.3 A one-character RE followed by \{m\}, \{m,\}, or \{m,n\) is a RE that matches 
a range of occurrences of the one-character RE. The values of m and n must be 
non-negative integers less than 256; \{m\} matches exactly m occurrences; 
\{m,\} matches at least m occurrences; \{m,n\] matches any number of 
occurrences between m and n inclusive. Whenever a choice exists, the RE 
matches as many occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of the strings 
matched by each component of the RE. 

2.5 A RE enclosed between the character sequences \( and \) is a RE that matches 
whatever the unadorned RE matches. 

2.6 The expression \n matches the same string of characters as was matched by an 
expression enclosed between \( and \) earlier in the same RE. Here n is a digit; 
the sub-expression specified is that beginning with the n-th occurrence of \( 
counting from the left. For example, the expression A \(.*\)\1$ matches a line 
consisting of two repeated appearances of the same string. 

Finally, an entire RE may be constrained to match only an initial segment or final seg- 
ment of a line (or both). 
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3.1 A circumflex ( A ) at the beginning of an entire RE constrains that RE to match an 
initial segment of a line. 

3.2 A dollar sign ($) at the end of an entire RE constrains that RE to match a final 
segment of a line. 

The construction A entire RE $ constrains the entire RE to match the entire line. 

The null RE (e.g., //) is equivalent to the last RE encountered. See also the last para- 
graph before FILES below. 

To understand addressing in ed it is necessary to know that at any time there is a 
current line. Generally speaking, the current line is the last line affected by a com- 
mand; the exact effect on the current line is discussed under the description of each 
command. Addresses are constructed as follows: 

1. The character . addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. f x addresses the line marked with the mark name character x r which must be a 
lower-case letter. Lines are marked with the k command described below. 

5. A RE enclosed by slashes (/) addresses the first line found by searching forward 
from the line following the current line toward the end of the buffer and stop- 
ping at the first line containing a string matching the RE. If necessary, the search 
wraps around to the beginning of the buffer and continues up to and including 
the current line, so that the entire buffer is searched. See also the last paragraph 
before FILES below. 

6. A RE enclosed in question marks (?) addresses the first line found by searching 
backward from the line preceding the current line toward the beginning of the 
buffer and stopping at the first line containing a string matching the RE. If 
necessary, the search wraps around to the end of the buffer and continues up to 
and including the current line. See also the last paragraph before FILES below. 

7. An address followed by a plus sign (+) or a minus sign (-) followed by a 
decimal number specifies that address plus (respectively minus) the indicated 
number of lines. The plus sign may be omitted. 

8. If an address begins with + or -, the addition or subtraction is taken with 
respect to the current line; e.g, -5 is understood to mean .-5. 

9. If an address ends with + or -, then 1 is added to or subtracted from the 
address, respectively. As a consequence of this rule and of Rule 8, immediately 
above, the address - refers to the line preceding the current line. (To maintain 
compatibility with earlier versions of the editor, the character A in addresses is 
entirely equivalent to -.) Moreover, trailing + and - characters have a cumula- 
tive effect, so — refers to the current LINE LESS 2. 

10. For convenience, a comma (,) stands for the address pair 1,$, while a semicolon 
(;) stands for the pair .,$. 

Commands may require zero, one, or two addresses. Commands that require no 
addresses regard the presence of an address as an error. Commands that accept one 
or two addresses assume default addresses when an insufficient number of addresses 
is given; if more addresses are given than such a command requires, the last one(s) 
are used. 

Typically, addresses are separated from each other by a comma (,). They may also 
be separated by a semicolon (;). In the latter case, the current line (.) is set to the first 
address, and only then is the second address calculated. This feature can be used to 
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determine the starting line for forward and backward searches (see Rules 5 and 6, I 

above). The second address of any two-address sequence must correspond to a line V. 

that follows, in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown in parentheses. 
The parentheses are not part of the address; they show that the given addresses are 
the default. 

It is generally illegal for more than one command to appear on a line. However, any 
command (except e, f, r,orw) may be suffixed by 1, n, or p in which case the current 
line is either listed, numbered or printed, respectively, as discussed below under the 
Z, n, and p commands. 

<.)a 

<text> 

The append command reads the given text and appends it after the addressed 
line; . is left at the last inserted line, or, if there were none, at the addressed line. 
Address is legal for this command: it causes the "appended" text to be placed 
at the beginning of the buffer. The maximum number of characters that may be 
entered from a terminal is 256 per line (including the new-line character). 

<.)c 

<text> 

The change command deletes the addressed lines, then accepts input text that 
replaces these lines; . is left at the last line input, or, if there were none, at the 
first line that was not deleted. 



(.,.)d 

The delete command deletes the addressed lines from the buffer. The line after 
the last line deleted becomes the current line; if the lines deleted were originally 
at the end of the buffer, the new last line becomes the current line. 



efile 



Efile 
{file 



The edit command causes the entire contents of the buffer to be deleted, and 
then the named file to be read in; . is set to the last line of the buffer. If no file 
name is given, the currently-remembered file name, if any, is used (see the / 
command). The number of characters read is typed; file is remembered for pos- 
sible use as a default file name in subsequent e, r, and w commands. If file is 
replaced by !, the rest of the line is taken to be a shell (sfa(D) command whose 
output is to be read. Such a shell command is not remembered as the current 
file name. See also DIAGNOSTICS below. 

The Edit command is like e r except that the editor does not check to see if any 
changes have been made to the buffer since the last w command. 

If file is given, the /ile-name command changes the currently-remembered file 
name to file; otherwise, it prints the currently-remembered file name. 



( 



( 1 , $ )g/RE/ command list 

In the global command, the first step is to mark every line that matches the 
given RE. Then, for every such line, the given command list is executed with . 
initially set to that line. A single command or the first of a list of commands 
appears on the same line as the global command. All lines of a multi-line list 
except the last line must be ended with a \; a, i, and c commands and associ- 
ated input are permitted. The . terminating input mode may be omitted if it ^ 
would be the last line of the command list. An empty command list is equivalent V 
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to the p command. The g r G r v, and V commands are not permitted in the com- 
mand list. See also BUGS and the last paragraph before FILES below. 

(1,$)G/KE/ 

In the interactive Global command, the first step is to mark every line that 
matches the given RE. Then, for every such line, that line is printed, . is 
changed to that line, and any one command (other than one of the a, c, i, g, G, 
v, and V commands) may be input and is executed. After the execution of that 
command, the next marked line is printed, and so on; a new-line acts as a null 
command; an & causes the re-execution of the most recent command executed 
within the current invocation of G. Note that the commands input as part of 
the execution of the G command may address and affect any lines in the buffer. 
The G command can be terminated by an interrupt signal (ASCII DEL or 
BREAK). 

h 

The help command gives a short error message that explains the reason for the 
most recent ? diagnostic. 



H 



The Help command causes ed to enter a mode in which error messages are 
printed for all subsequent ? diagnostics. It will also explain the previous ? if 
there was one. The H command alternately turns this mode on and off; it is ini- 
tially off. 

(.)i 
<text> 

The insert command inserts the given text before the addressed line; . is left at 
the last inserted line, or, if there were none, at the addressed line. This com- 
mand differs from the a command only in the placement of the input text. 
Address is not legal for this command. The maximum number of characters 
that may be entered from a terminal is 256 per line (including the new-line 
character). 

The join command joins contiguous lines by removing the appropriate new- 
line characters. If exactly one address is given, this command does nothing. 

(.)kx 

The marfc command marks the addressed line with name x, which must be a 
lower-case letter. The address 'x then addresses this line; . is unchanged. 

The list command prints the addressed lines in an unambiguous way: a few 
non-printing characters (e.g., tab, backspace) are represented by visually 
mnemonic overstrikes. All other non-printing characters are printed in octal, 
and long lines are folded. An I command may be appended to any other com- 
mand other than e,f, r, or w. 

(.,.)ma 

The move command repositions the addressed line(s) after the line addressed 
by a. Address is legal for a and causes the addressed line(s) to be moved to 
the beginning of the file. It is an error if address a falls within the range of 
moved lines; . is left at the last line moved. 

(.,.)n 

The number command prints the addressed lines, preceding each line by its 
line number and a tab character; . is left at the last line printed. The n com- 
mand may be appended to any other command other than e,f, r,oxw. 
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(.,.)p 

The print command prints the addressed lines; . is left at the last line printed. 
The p command may be appended to any other command other than e, f, r, or 
w. For example, dp deletes the current line and prints the new current line. 

P 

The editor will prompt with a * for all subsequent commands. The P command 
alternately turns this mode on and off; it is initially off. 

The guit command causes ed to exit. No automatic write of a file is done; how- 
ever, see DIAGNOSTICS , below. 

The editor exits without checking if changes have been made in the buffer since 
the last w command. 

(%)tfile 

The read command reads in the given file after the addressed line. If no file 
name is given, the currently-remembered file name, if any, is used (see e and / 
commands). The currently-remembered file name is not changed unless file is 
the very first file name mentioned since ed was invoked. Address is legal for 
r and causes the file to be read at the beginning of the buffer. If the read is suc- 
cessful, the number of characters read is typed; . is set to the last line read in. If 
file is replaced by !, the rest of the line is taken to be a shell (sh(D) command 
whose output is to be read. For example, "$r !ls" appends current directory to 
the end of the file being edited. Such a shell command is not remembered as 
the current file name. 

(.,.)$/RE /replacement/ or | 

( . , . )s/RE/replacernent/g or ^ 

(.,.)s/RE /replacement /n n = 1-512 

The substitute command searches each addressed line for an occurrence of the 
specified RE. In each line in which a match is found, all (non-overlapped) 
matched strings are replaced by the replacement if the global replacement indi- 
cator g appears after the command. If the global indicator does not appear, 
only the first occurrence of the matched string is replaced. If a number n 
appears after the command, only the n th occurrence of the matched string on 
each addressed line is replaced. It is an error for the substitution to fail on all 
addressed lines. Any character other than space or new-line may be used 
instead of / to delimit the RE and the replacement; . is left at the last line on 
which a substitution occurred. See also the last paragraph before FILES below. 

An ampersand (&) appearing in the replacement is replaced by the string 
matching the RE on the current line. The special meaning of & in this context 
may be suppressed by preceding it by \. As a more general feature, the charac- 
ters \n, where n is a digit, are replaced by the text matched by the n-th regular 
subexpression of the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is determined by counting 
occurrences of \( starting from the left. When the character % is the only char- 
acter in the replacement, the replacement used in the most recent substitute com- 
mand is used as the replacement in the current substitute command. The % 
loses its special meaning when it is in a replacement string of more than one 
character or is preceded by a V 

A line may be split by substituting a new-line character into it. The new-line in ^ 

the replacement must be escaped by preceding it by V Such substitution cannot | 

be done as part of a g or v command list. ^ 



148 Stardent 1500/3000 



Essential Utilities 



ED(1) ED ( 1 ) 

(.,.)ta 

This command acts just like the m command, except that a copy of the 
addressed lines is placed after address a (which may be 0); . is left at the last 
line of the copy. 



u 



The undo command nullifies the effect of the most recent command that 
modified anything in the buffer, namely the most recent a, c, d, g, i,j, m, r, s, t, 
v, G, or V command. 

( 1 , $ )wlRE I command list 

This command is the same as the global command g except that the command 
list is executed with . initially set to every line that does not match the RE. 

(1,$)V/jRE/ 

This command is the same as the interactive global command G except that the 
lines that are marked during the first step are those that do not match the RE. 

(I,$)w/z7e 

The write command writes the addressed lines into the named file. If the file 
does not exist, it is created with mode 666 (readable and writable by everyone), 
unless your umask setting (see umask(D) dictates otherwise. The currently- 
remembered file name is not changed unless file is the very first file name men- 
tioned since ed was invoked. If no file name is given, the currently- 
remembered file name, if any, is used (see e and / commands); • is unchanged. 
If the command is successful, the number of characters written is typed. If file 
is replaced by !, the rest of the line is taken to be a shell (sh(D) command whose 
standard input is the addressed lines. Such a shell command is not remem- 
bered as the current file name. 

X 

An encryption key is requested from the standard input. Subsequent e, r, and 
w commands will use this key to encrypt or decrypt the text (see cryptd)). An 
explicitly empty key turns off encryption. Also, see the -x option of ed. 

($)= 

The line number of the addressed line is typed; . is unchanged by this com- 
mand. 

Ishell command 

The remainder of the line after the ! is sent to the UNIX system shell (sft(D) to be 
interpreted as a command. Within the text of that command, the unescaped 
character % is replaced with the remembered file name; if a ! appears as the 
first character of the shell command, it is replaced with the text of the previous 
shell command. Thus, !! will repeat the last shell command. If any expansion is 
performed, the expanded line is echoed; . is unchanged. 

( .+1 )<new-line> 

An address alone on a line causes the addressed line to be printed. A new-line 
alone is equivalent to -+lp; it is useful for stepping forward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and returns to its 
command level. 

Some size limitations: 512 characters per line, 256 characters per global command 
list, and 64 characters per file name. The limit on the number of lines depends on the 
amount of user memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters. Files (e.g., a.out) that contain 
characters not in the ASCII set (bit 8 on) cannot be edited by ed. 
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FILES 



DIAGNOSTICS 



SEE ALSO 
BUGS 



WARNINGS 



If a file is not terminated by a new-line character, ed adds one and outputs a message 
explaining what it did. 

If the closing delimiter of a RE or of a replacement string (e.g., /) would be the last 
character before a new-line, that delimiter may be omitted, in which case the 
addressed line is printed. The following pairs of commands are equivalent: 

s/sl/s2 s/sl/s2/p 

g/sl g/sl/p 

?sl ?sl? 

/usr/tmp default directory for temporary work file. 

$TMPDIR if this environmental variable is not null, its value is used in place of 

/usr/tmp as the directory name for the temporary work file, 
ed.hup work is saved here if the terminal is hung up. 

? for command errors. 

Ifile for an inaccessible file. 

(use the help and Help commands for detailed explanations). 

If changes have been made in the buffer since the last w command that wrote the 
entire buffer, ed warns the user if an attempt is made to destroy ed's buffer via the e 
or q commands. It prints ? and allows one to continue editing. A second e or q com- 
mand at this point will take effect. The -s command-line option inhibits this feature. 

edit(l), ex(l), grep(l), sed(l), sh(l), stty(l), umask(l), vi(l), fspec(4), regexp(5). 

A / command cannot be subject to a g or a v command. 

The / command and the ! escape from the e, r, and w commands cannot be used if the 
editor is invoked from a restricted shell (see sh(l)). 

The sequence \n in a RE does not match a new-line character. 

Characters are masked to 7 bits on input. 

If the editor input is coming from a command file (e.g., ed file < ed-cmd-file), the edi- 
tor will exit at the first failure. 

The -x option is provided with the Security Administration Utilities, which is avail- 
able only in the United States. 

The - option, although supported in this release for upward compatibility, will no 
longer be supported in the next major release of the system. Convert shell scripts 
that use the - option to use the -s option, instead. 
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SYNOPSIS 

DESCRIPTION 



EDIT(1) 



edit - text editor (variant of ex for casual users) 



edit [ -r ] [ -x ] name . 



edit is a variant of the text editor ex recommended for new or casual users who wish 
to use a command-oriented editor. 



-r 



Recover file after an editor or system crash. 



-x Encryption option; when this option is used, the file will be encrypted as it is 
being written and will require an encryption key to be read (see crypt(D). Also, 
see the WARNING section at the end of this manual page. 

The following brief introduction should help you get started with edit. If you are 
using a CRT terminal you may want to learn about the display editor vi. 

To edit the contents of an existing file you begin with the command ''edit name" to 
the shell, edit makes a copy of the file which you can then edit, and tells you how 
many lines and characters are in the file. To create a new file, just make up a name 
for the file and try to run edit on it; you will cause an error diagnostic, but do not 
worry. 

edit prompts for commands with the character ':', which you should see after starting 
the editor. If you are editing an existing file, then you will have some lines in edit's 
buffer (its name for the copy of the file you are editing). Most commands to edit use 
its "current line" if you do not tell them which line to use. Thus if you say print 
(which can be abbreviated p) and hit carriage return (as you should after all edit com- 
mands) this current line will be printed. If you delete (d) the current line, edit will 
print the new current line. When you start editing, edit makes the last line of the file 
the current line. If you delete this last line, then the new last line becomes the 
current one. In general, after a delete, the next line in the file becomes the current 
line. (Deleting the last line is a special case.) 

If you start with an empty file or wish to add some new lines, then the append (a) 
command can be used. After you give this command (typing a carriage return after 
the word append) edit will read lines from your terminal until you give a line consist- 
ing of just a ".", placing these lines after the current line. The last line you type then 
becomes the current line. The command insert (i) is like append but places the lines 
you give before, rather than after, the current line. 

edit numbers the lines in the buffer, with the first line having number 1. If you give 
the command "1" then edit will type this first line. If you then give the command 
delete edit will delete the first line, line 2 will become line 1, and edit will print the 
current line (the new line 1) so you can see where you are. In general, the current 
line will always be the last line affected by a command. 

You can make a change to some text within the current line by using the substitute 
(s) command. You say "s/old /new/" where old is replaced by the old characters you 
want to get rid of and new is the new characters you want to replace it with. 

The command file (f) will tell you how many lines there are in the buffer you are 
editing and will say "[Modified]" if you have changed it. After modifying a file you 
can put the buffer text back to replace the file by giving a write (w) command. You 
can then leave the editor by issuing a quit (q) command. If you run edit on a file, but 
do not change it, it is not necessary (but does no harm) to write the file back. If you 
try to quit from edit after modifying the buffer without writing it out, you will be 
warned that there has been "No write since last change" and edit will await another 
command. If you wish not to write the buffer out then you can issue another quit 
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command. The buffer is then irretrievably discarded, and you return to the shell. 

By using the delete and append commands, and giving line numbers to see lines in 
the file you can make any changes you desire. You should learn at least a few more 
things, however, if you are to use edit more than a few times. 

The change (c) command will change the current line to a sequence of lines you sup- 
ply (as in append you give lines up to a line consisting of only a "."). You can tell 
change to change more than one line by giving the line numbers of the lines you 
want to change, i.e., "3,5change". You can print lines this way too. Thus "l,23p" 
prints the first 23 lines of the file. 

The undo (u) command will reverse the effect of the last command you gave which 
changed the buffer. Thus if you give a substitute command which does not do what 
you want, you can say undo and the old contents of the line will be restored. You 
can also undo an undo command so that you can continue to change your mind, edit 
will give you a warning message when commands you do affect more than one line 
of the buffer. If the amount of change seems unreasonable, you should consider 
doing an undo and looking to see what happened. If you decide that the change is 
ok, then you can undo again to get it back. Note that commands such as write and 
quit cannot be undone. 

To look at the next line in the buffer you can just hit carriage return. To look at a 
number of lines hit A D (control key and, while it is held down D key, then let up 
both) rather than carriage return. This will show you a half screen of lines on a CRT 
or 12 lines on a hardcopy terminal. You can look at the text around where you are by 
giving the command "z.". The current line will then be the last line printed; you can 
get back to the line where you were before the "z." command by saying """ . The z 
command can also be given other following characters "z-" prints a screen of text (or 
24 lines) ending where you are; "z+" prints the next screenful. If you want less than 
a screenful of lines, type in "z.12" to get 12 lines total. This method of giving counts 
works in general; thus you can delete 5 lines starting with the current line with the 
command "delete 5". 

To find things in the file, you can use line numbers if you happen to know them; 
since the line numbers change when you insert and delete lines this is somewhat 
unreliable. You can search backwards and forwards in the file for strings by giving 
commands of the form /text/ to search forward for text or ?text? to search backward 
for text . If a search reaches the end of the file without finding the text it wraps, end 
around, and continues to search back to the line where you are. A useful feature here 
is a search of the form / A text/ which searches for text at the beginning of a line. Simi- 
larly /text$/ searches for text at the end of a line. You can leave off the trailing / or ? 
in these commands. 

The current line has a symbolic name "."; this is most useful in a range of lines as in 
// .,$print ,, which prints the rest of the lines in the file. To get to the last line in the file 
you can refer to it by its symbolic name "$". Thus the command "$ delete" or "$d" 
deletes the last line in the file, no matter which line was the current line before. 
Arithmetic with line references is also possible. Thus the line "$-5" is the fifth before 
the last, and ".+20" is 20 lines after the present. 

You can find out which line you are at by doing ".=". This is useful if you wish to 

move or copy a section of text within a file or between files. Find out the first and 

last line numbers you wish to copy or move (say 10 to 20). For a move you can then 

say "10,20delete a" which deletes these lines from the file and places them in a buffer 

named a. edit has 26 such buffers named a through z. You can later get these lines ^ 

back by doing "put a" to put the contents of buffer a after the current line. If you | 

want to move or copy these lines between files you can give an edit (e) command ^~ 
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after copying the lines, following it with the name of the other file you wish to edit, 
i.e., "edit chapter2". By changing delete to yank above you can get a pattern for copy- 
ing lines. If the text you wish to move or copy is all within one file then you can just 
say "lO^Omove $" for example. It is not necessary to use named buffers in this case 
(but you can if you wish). 

SEE ALSO 

ed(l),ex(l),vi(l). 

WARNING 

The -x option is provided with the Security Administration Utilities, which is avail- 
able only in the United States. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 

BUGS 



EGREP(1) 



egrep - search a file for a pattern using full regular expressions 

egrep [options] full regular expression [file ...] 

egrep (expression grep) searches files for a pattern of characters and prints all lines that 
contain that pattern, egrep uses full regular expressions (expressions that have string 
values that use the full set of alphanumeric and special characters) to match the pat- 
terns. It uses a fast deterministic algorithm that sometimes needs exponential space. 

egrep accepts full regular expressions as in ed(l), except for \( and \), with the addi- 
tion of: 

1. A full regular expression followed by + that matches one or more occurrences 
of the full regular expression. 

2. A full regular expression followed by ? that matches or 1 occurrences of the 
full regular expression. 

3. Full regular expressions separated by I or by a new-line that match strings 
that are matched by any of the expressions. 

4. A full regular expression that may be enclosed in parentheses ( ) for grouping. 

Be careful using the characters $, *, [, A , I , (, ), and \ in full regular expression, because 
they are also meaningful to the shell. It is safest to enclose the entire full regular 
expression in single quotes '...'. 

The order of precedence of operators is [], then * ?+, then concatenation, then I and 
new-line. 

If no files are specified, egrep assumes standard input. Normally, each line found is 
copied to the standard output. The file name is printed before each line found if 
there is more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it was found. This can be 

useful in locating block numbers by context (first block is 0). 

Print only a count of the lines that contain the pattern. 

Ignore upper/ lower case distinction during comparisons. 

Print the names of files with matching lines once, separated by new-lines. 

Does not repeat the names of files when the pattern is found more than once. 

Precede each line by its line number in the file (first line is 1). 

Print all lines except those that contain the pattern, 
-e special_expression 

Search for a special expression (full regular expression that begins with a -). 
-f file Take the list of full regular expressions from file. 

ed(l), fgrep(l), grep(l), sed(l), sh(l). 

Exit status is if any matches are found, 1 if none, 2 for syntax errors or inaccessible 
files (even if matches were found). 

Ideally there should be only one grep command, but there is not a single algorithm 
that spans a wide enough range of space-time tradeoffs. Lines are limited to BUFSIZ 
characters; longer lines are truncated. BUFSIZ is defined in /usr/include/stdio.h. 



-c 
-i 
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-v 
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NAME 
SYNOPSIS 



enable, disable - enable/ disable LP printers 



enable printers 

disable [-c] [-r[ reason]] printers 

DESCRIPTION 

enable activates the named printers, enabling them to print requests taken by lp(l). 
Use lpstat(l) to find the status of printers. 

Disable deactivates the named printers, disabling them from printing requests taken 
by lp(l). By default, any requests that are currently printing on the designated 
printers will be reprinted in their entirety either on the same printer or on another 
member of the same class. Use Ipstatd) to find the status of printers. Options useful 
with disable are: 

-c Cancel any requests that are currently printing on any of the designated 

printers. 

-r[ reason] Associates a reason with the deactivation of the printers. This reason 
applies to all printers mentioned up to the next -r option. If the -r 
option is not present or the -r option is given without a reason, then a 
default reason will be used. Reason is reported by Ipstatd). 



FILES 
SEE ALSO 



/usr/spool/lp/* 
lp(l), Ipstatd). 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
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env - set environment for command execution 

env [-] [ name= value ] ... [ command args ] 

env obtains the current environment, modifies it according to its arguments, then exe- 
cutes the command with the modified environment. Arguments of the form 
name-value are merged into the inherited environment before the command is exe- 
cuted. The - flag causes the inherited environment to be ignored completely, so that 
the command is executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one name-value 
pair per line. 

sh(l), exec(2), profile(4), environ(5). 
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error - analyze and disperse compiler error messages 

error [ -n ] [ -s ] [ -q ] [ -v ] [ -t suffixlist ] [ -I ignorefile ] [ name ] 

Error analyzes and optionally disperses the diagnostic error messages produced by a 
number of compilers and language processors to the source file and line where the 
errors occurred. It can replace the painful, traditional methods of scribbling abbrevi- 
ations of errors on paper, and permits error messages and source code to be viewed 
simultaneously without machinations of multiple windows in a screen editor. 

Error looks at the error messages, either from the specified file name or from the stan- 
dard input, and attempts to determine which language processor produced each 
error message, determines the source file and line number to which the error mes- 
sage refers, determines if the error message is to be ignored or not, and inserts the 
(possibly slightly modified) error message into the source file as a comment on the 
line preceding to which the line the error message refers. Error messages which can't 
be categorized by language processor or content are not inserted into any file, but are 
sent to the standard output. Error touches source files only after all input has been 
read. By specifying the -q query option, the user is asked to confirm any potentially 
dangerous (such as touching a file) or verbose action. Otherwise error proceeds on its 
merry business. If the -t touch option and associated suffix list is given, error will 
restrict itself to touch only those files with suffices in the suffix list. Error also can be 
asked (by specifying -v) to invoke vi(l) on the files in which error messages were 
inserted; this obviates the need to remember the names of the files with errors. 

Error is intended to be run with its standard input connected via a pipe to the error 
message source. Some language processors put error messages on their standard 
error file; others put their messages on the standard output. Hence, both error 
sources should be piped together into error. For example, when using the csh syntax, 

make -s lint I & error -q -v 

will analyze all the error messages produced by whatever programs make runs when 
making lint. 

Error knows about the error messages produced by: make, cc, cpp, ccom, as, Id, lint, pi, 
pc, f77, and DEC Western Research Modula-2. Error knows a standard format for error 
messages produced by the language processors, so is sensitive to changes in these 
formats. For all languages except Pascal, error messages are restricted to be on one 
line. Some error messages refer to more than one line in more than one files; error 
will duplicate the error message and insert it at all of the places referenced. 

Error will do one of six things with error messages. 

synchronize 

Some language processors produce short errors describing which file it is 
processing. Error uses these to determine the file name for languages that 
don't include the file name in each error message. These synchronization 
messages are consumed entirely by error. 

discard Error messages from lint that refer to one of the two lint libraries, 
/usr/lib/llib-lc and /usr/lib/llib-port are discarded, to prevent accidently 
touching these libraries. Again, these error messages are consumed 
entirely by error. 

nullify Error messages from lint can be nullified if they refer to a specific func- 
tion, which is known to generate diagnostics which are not interesting; 
Nullified error messages are not inserted into the source file, but are 
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AUTHOR 



written to the standard output. The names of functions to ignore are 
taken from either the file named .errorrc in the users' s home directory, or 
from the file named by the -I option. If the file does not exist, no error 
messages are nullified. If the file does exist, there must be one function 
name per line. 

not file specific 

Error messages that can't be intuited are grouped together, and written to 
the standard output before any files are touched. They will not be 
inserted into any source file. 

file specific Error message that refer to a specific file, but to no specific line, are writ- 
ten to the standard output when that file is touched. 

true errors Error messages that can be intuited are candidates for insertion into the 
file to which they refer. 

Only true error messages are candidates for inserting into the file they refer to. Other 
error messages are consumed entirely by error or are written to the standard output. 
Error inserts the error messages into the source file on the line preceding the line the 
language processor found in error. Each error message is turned into a one line com- 
ment for the language, and is internally flagged with the string "###" at the begin- 
ning of the error, and "%%%" at the end of the error. This makes pattern searching 
for errors easier with an editor, and allows the messages to be easily removed. In 
addition, each error message contains the source line number for the line the message 
refers to. A reasonably formatted source program can be recompiled with the error 
messages still in it, without having the error messages themselves cause future 
errors. For poorly formatted source programs in free format languages, such as C or 
Pascal, it is possible to insert a comment into another comment, which can wreak 
havoc with a future compilation. To avoid this, programs with comments and source 
on the same line should be formatted so that language statements appear before com- 
ments. 

Options available with error are: 

Do not touch any files; all error messages are sent to the standard output. 

The user is queried whether s/he wants to touch the file. A "y" or "n" to the 
question is necessary to continue. Absence of the -q option implies that all 
referenced files (except those referring to discarded error messages) are to be 
touched. 

After all files have been touched, overlay the visual editor vi with it set up to 
edit all files touched, and positioned in the first touched file at the first error. If 
vi can't be found, try ex or ed from standard places. 

Take the following argument as a suffix list. Files whose suffixes do not appear 
in the suffix list are not touched. The suffix list is dot separated, and "*" wild- 
cards work. Thus the suffix list: 

".c.y.foo*.h" 

allows error to touch files ending with ".c", ".y", "ioo*" and ".y". 

Print out statistics regarding the error categorization. Not too useful. 



-n 



-q 



-s 



Error catches interrupt and terminate signals, and if in the insertion phase, will ord- 
erly terminate what it is doing. 

Robert Henry 
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FILES 

~l .errorrc function names to ignore for lint error messages 

/dev/tty user's teletype 



BUGS 



Opens the teletype directly to do user querying. 

Source files with links make a new copy of the file with only one link to it. 

Changing a language processor's format of error messages may cause error to not 
understand the error message. 

Error, since it is purely mechanical, will not filter out subsequent errors caused by 
'floodgating' initiated by one syntactically trivial error. Humans are still much better 
at discarding these related errors. 

Pascal error messages belong after the lines affected (error puts them before). The 
alignment of the ' I ' marking the point of error is also disturbed by error. 

Error was designed for work on CRT's at reasonably high speed. It is less pleasant on 
slow speed terminals, and has never been used on hardcopy terminals. 
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For ed Users 
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ex - text editor 

ex [ - ] [ -v ] [ -t tag ] [ -r ] [ -R ] [ -x ] [ ^command ] name ... 

ex is the root of a family of editors: ex and z?i. ex is a superset of ed, with the most 
notable extension being a display editing facility. Display based editing is the focus 
oivi. 

If you have a CRT terminal, you may wish to use a display based editor; in this case 
see vi (1), which is a command which focuses on the display editing portion of ex. 

If you have used ed you will find that ex has a number of new features useful on CRT 
terminals. Intelligent terminals and high speed terminals are very pleasant to use 
with vi. Generally, the editor uses far more of the capabilities of terminals than ed 
does, and uses the terminal capability data base (see Terminal Information Utilities 
Guide) and the type of the terminal you are using from the variable TERM in the 
environment to determine how to drive your terminal efficiently. The editor makes 
use of features such as insert and delete character and line in its visual command 
(which can be abbreviated vi) and which is the central mode of editing when using 
vi(l). 

ex contains a number of new features for easily viewing the text of the file. The z 
command gives easy access to windows of text. Hitting A D causes the editor to scroll 
a half -window of text and is more useful for quickly stepping through a file than just 
hitting return. Of course, the screen-oriented visual mode gives constant access to 
editing context. 

ex gives you more help when you make mistakes. The undo (u) command allows 
you to reverse any single change which goes astray, ex gives you a lot of feedback, 
normally printing changed lines, and indicates when more than a few lines are 
affected by a command so that it is easy to detect when a command has affected 
more lines than it should have. 

The editor also normally prevents overwriting existing files unless you edited them 
so that you do not accidentally clobber with a write a file other than the one you are 
editing. If the system (or editor) crashes, or you accidentally hang up the telephone, 
you can use the editor recover command to retrieve your work. This will get you 
back to within a few lines of where you left off. 

ex has several features for dealing with more than one file at a time. You can give it a 
list of files on the command line and use the next (n) command to deal with each in 
turn. The next command can also be given a list of file names, or a pattern as used by 
the shell to specify a new set of files to be dealt with. In general, file names in the 
editor may be formed with full shell metasyntax. The metacharacter '%' is also avail- 
able in forming file names and is replaced by the name of the current file. 

For moving text between files and within a file the editor has a group of buffers, 
named a through z. You can place text in these named buffers and carry it over when 
you edit another file. 

There is a command & in ex which repeats the last substitute command. In addition 
there is a confirmed substitute command. You give a range of substitutions to be 
done and the editor interactively asks whether each substitution is desired. 

It is possible to ignore case of letters in searches and substitutions, ex also allows reg- 
ular expressions which match words to be constructed. This is convenient, for exam- 
ple, in searching for the word "edit" if your document also contains the word 
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"editor." 

ex has a set of options which you can set to tailor it to your liking. One option which 
is very useful is the autoindent option which allows the editor to automatically sup- 
ply leading white space to align text. You can then use the A D key as a backtab and 
space and tab forward to align new code easily. 

Miscellaneous new useful features include an intelligent join (j) command which 
supplies white space between joined lines automatically, commands < and > which 
shift groups of lines, and the ability to filter portions of the buffer through commands 
such as sort. 

INVOCATION OPTIONS 

The following invocation options are interpreted by ex : 

- Suppress all interactive-user feedback. This is useful in processing 

editor scripts. 

Invokes vi 



-v 

-t tagfR 

-tfile 
-R 



■{■command 



Edit the file containing the tag and position the editor at its 
definition. 

Recover file after an editor or system crash. If file is not specified a 
list of all saved files will be printed. 

Readonly mode set, prevents accidentally overwriting the file. 

Encryption option; when this option is used, the file will be 
encrypted as it is being written and will require an encryption key 
to be read (see crypt(D). Also, see the WARNING section at the end 
of this manual page. 

Begin editing by executing the specified editor search or positioning 

command . 



The name argument indicates files to be edited. 



ex States 



Command 



Insert 



Visual 



Normal and initial state. Input prompted for by :. Your kill charac- 
ter cancels partial command. 

Entered by a, i, or c. Arbitrary text may be entered. Insert is nor- 
mally terminated by a line having only . on it, or abnormally with 
an interrupt. 

Entered by vi, terminates with Q or A \. 



ex command names and abbreviations 








abbrev 


ab 


next 


n 


unabbrev 


una 


append 


a 


number 


nu 


undo 


u 


args 


ar 






unmap 


unm 


change 


c 


preserve 


pre 


version 


ve 


copy 


CO 


print 


P 


visual 


vi 


delete 


d 


put 


pu 


write 


w 


edit 


e 


quit 


q 


xit 


X 


file 


f 


read 


re 


yank 


y* 


global 


g 


recover 


rec 


window 


z 


insert 


i 


rewind 


rew 


escape 


f 


join 


j 


set 


se 


lshift 


< 


list 


1 


shell 


sh 


print next 


CR 
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map 

mark 

move 

ex Command Addresses 



n 
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ma 
m 



source 

stop 

substitute 



% 



linen 

current 

last 

next 

previous 

n forward 

U 



/pat 

Ipat 

x-n 

x,y 

'x 



so resubst & 

st rshift > 

s scroll A D 

next with pat 
previous with pat 
n before x 
x through y 
marked with x 
previous context 



( 



Initializing options 



EXINIT 
$HOME/.exrc 

J.exrc 
set* 
set nox 
set x-val 
set 

set all 
setx? 

Most useful options 

autoindent 

autowrite 

ignorecase 

list 

magic 

number 

paragraphs 

redraw 

scroll 

sections 

shiftwidth 

showmatch 

showmode 

slowopen 

window 

wrapscan 

wrapmargin 

Scanning pattern formation 

A 

$ 

\< 
\> 

[str] 

[Tsfr] 

[x-y] 



place set's here in environment var. 

editor initialization file 

editor initialization file 

enable option 

disable option 

give value vol 

show changed options 

show all options 

show value of option x 



ai 

aw 

ic 



nu 



para 



sect 

sw 

sm 

smd 

slow 

ws 
wm 



supply indent 

write before changing files 

in scanning 

print A I for tab, $ at end 

. [ * special in patterns 

number lines 

macro names which start ... 

simulate smart terminal 

command mode lines 

macro names ... 

for < >, and input A D 

to ) and } as typed 

show insert mode in vi 

stop updates during insert 

visual mode lines 

around end of buffer? 

automatic line splitting 



( 



beginning of line 

end of line 

any character 

beginning of word 

end of word 

any char in str 

... not in str 

... between x and y 

any number of preceding 



AUTHOR 



Vi and ex are based on software developed by The University of California, Berkeley 
California, Computer Science Division, Department of Electrical Engineering and 
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FILES 



SEE ALSO 



WARNING 



BUGS 



Computer Science. 

/usr/lib/ex?.?strings 

/usr/lib/ex?.?recover 

/usr/lib/ex?.?preserve 

/usr/lib/*/* 

$HOME/.exrc 

./.exrc 

/tmp/Exnnnnn 

/tmp/Rxnnnnn 

/usr/ preserve /login 



error messages 

recover command 

preserve command 

describes capabilities of terminals 

editor startup file 

editor startup file 

editor temporary 

named buffer temporary 

preservation directory 

(where login is the user's login) 



awk(l), ed(l), edit(l), grep(l), sed(l), vi(l). 

curses(3X), term(4), terminfo(4) in the Programmer's Reference Manual. 

The Terminal Information Utilities Guide. 

The -x option is provided with the Security Administration Utilities, which is avail- 
able only in the United States. 

The undo command causes all marks to be lost on lines changed and then restored if 
the marked lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. More than a 
screen full of output may result if long lines are present. 

File input/output errors do not print a name if the command line / -' option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used before exit- 
ing the editor. 

Null characters are discarded in input files and cannot appear in resultant files. 
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NAME 
SYNOPSIS 



expand, unexpand - expand tabs to spaces, and vice versa 

expand [ -tabstop ] [ -tabl,tab2,...,tabn ] [ file ... ] 
unexpand [ -a ] [ file ... ] 



( 



DESCRIPTION 

Expand processes the named files or the standard input writing the standard output 
with tabs changed into blanks. Backspace characters are preserved into the output 
and decrement the column count for tab calculations. Expand is useful for pre- 
processing character files (before sorting, looking at specific columns, etc.) that con- 
tain tabs. 

If a single tabstop argument is given, then tabs are set tabstop spaces apart instead of 
the default 8. If multiple tabstops are given then the tabs are set at those specific 
columns. 

Unexpand puts tabs back into the data from the standard input or the named files and 
writes the result on the standard output. By default, only leading blanks and tabs are 
reconverted to maximal strings of tabs. If the -a option is given, then tabs are 
inserted whenever they would compress the resultant file by replacing two or more 
characters. 



( 



( 



1§4 Siameni 1500/3000 



Essential Utilities 



EXPR(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLES 



EXPR(1) 



expr - evaluate arguments as an expression 

expr arguments 

The arguments are taken as an expression. After evaluation, the result is written on 
the standard output. Terms of the expression must be separated by blanks. Charac- 
ters special to the shell must be escaped. Note that is returned to indicate a zero 
value, rather than the null string. Strings containing blanks or other special charac- 
ters should be quoted. Integer-valued arguments may be preceded by a unary minus 
sign. Internally, integers are treated as 32-bit, 2s complement numbers. 

The operators and keywords are listed below. Characters that need to be escaped are 
preceded by V The list is in order of increasing precedence, with equal precedence 
operators grouped within {} symbols. 

expr \ I expr 

returns the first expr if it is neither null nor 0, otherwise returns the second 
expr. 

expr \& expr 

returns the first expr if neither expr is null or 0, otherwise returns 0. 

expr { =, \>, \>=, \<, \<=, != ) expr 

returns the result of an integer comparison if both arguments are integers, 
otherwise returns the result of a lexical comparison. 

expr { +, - } expr 

addition or subtraction of integer-valued arguments. 

expr { \*, /, % } expr 

multiplication, division, or remainder of the integer- valued arguments. 

expr : expr 

The matching operator : compares the first argument with the second argu- 
ment which must be a regular expression. Regular expression syntax is the 
same as that of ed{\), except that all patterns are "anchored" (i.e., begin with 
A ) and, therefore, A is not a special character, in that context. Normally, the 
matching operator returns the number of characters matched (0 on failure). 
Alternatively, the \( . . . \) pattern symbols can be used to return a portion of 
the first argument. 

1. a= v expr $a + l v 

adds 1 to the shell variable a. 

2. # 'For $a equal to either 7 usr/abc/file" or just "file" ' 
expr $a : '.*/\(.*\)' \l $a 

returns the last segment of a path name (i.e., file). Watch out for / alone as 
an argument: expr will take it as the division operator (see BUGS below). 

3. # A better representation of example 2. 
expr //$a : '.*/\(.*\)' 

The addition of the // characters eliminates any ambiguity about the divi- 
sion operator and simplifies the whole expression. 

4. expr $VAR : '.*' 
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BUGS 



EXPR(1) 



returns the number of characters in $VAR. 



ed(l), sh(l). 

As a side effect of expression evaluation, expr returns the following exit values: 

if the expression is neither null nor 

1 if the expression is null or 

2 for invalid expressions. 

syntax error for operator/operand errors 

non-numeric argument if arithmetic is attempted on such a string 

After argument processing by the shell, expr cannot tell the difference between an 
operator and an operand except by the value. If $a is an =, the command: 

expr $a = '=' 

looks like: 

expr = = = 

as the arguments are passed to expr (and they will all be taken as the = operator). 
The following works: 

expr X$a = X= 



c 
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factor - obtain the prime factors of a number 

factor [ integer ] 

When you use factor without an argument, it waits for you to give it an integer. After 
you give it a positive integer less than or equal to 10 , it factors the integer, prints its 
prime factors the proper number of times, and then waits for another integer, factor 
exits if it encounters a zero or any non-numeric character. 

If you invoke factor with an argument, it factors the integer as described above, and 
then it exits. 

The maximum time to factor an integer is proportional to Vn. factor will take this 
time when n is prime or the square of a prime. 

factor prints the error message, "Ouch," for input out of range or for garbage input. 
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FC(1) 



f c - Fortran compiler 



f c [ options ] [ files ] [ options ] [ files ] 



The fc command is an interface to the Stardent 1500/3000 Compilation System. The 
compilation tools consist of a preprocessor, compiler, assembler, and link editor. The 
fc command processes the supplied options and then executes the various tools with 
the proper arguments. The fc command accepts several types of files as arguments: 

Files whose names end with .f are taken to be Fortran source programs and may be 
preprocessed, compiled, optimized, assembled, and link edited. The compilation 
process may be stopped after the completion of any pass if the appropriate options 
are supplied. If the compilation process runs through the assembler then an object 
program is produced and is left in the file whose name is that of the source with .o 
substituted for X However, the e o file is normally deleted if a single Fortran pro- 
gram is compiled and then immediately link edited. In the same way, files whose 
names end in .s are taken to be assembly source programs, and may be assembled 
and link edited; and files whose names end in .i are taken to be preprocessed Fortran 
source programs and may be compiled, optimized, assembled and link edited. Files 
whose names do not end in i, .s or .i are handed to the link editor. 

Since the fc command usually creates files in the current directory during the compi- 
lation process, it is necessary to run the fc command in a directory in which a file can 
be created. 

The following options are interpreted by fc: 

-all_doubles 

Set all undeclared floating point variables, all declared floating point variables, 
and floating point constants to be as if they were declared REAL*8. If they were 
COMPLEX*8, they are to COMPLEX*i6. Integers are allocated 8 bytes of storage 
instead of 4 bytes. 

-sist-number 

Allow the compiler to set the initial allocation for the program internal 
representation to the user defined number bytes. Normally, users should not 
invoke this flag unless the program is terminated with the internal error. 

-blanks72 

Pad with blanks on right to column 72. 

-c Suppress the link editing phase of the compilation, and do not remove any pro- 
duced object files. 

-case_sensitive 

Insist that user defined variables must be case sensitive. The default is 

-nocase__sensitive. 

-catalog-nameSn 

Create a database of functions available to be inlined. This option creates two 
files: the database nameAn and an associated file nameSd. Each use of catalog 
adds to the catalog; it does not replace previous versions. 

-continuations=n 

Set the number n of continuation lines the compiler accepts for any statement. 
The default is 19. 



c 



c 
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-cpp Invoke the C preprocessor on the source file before compiling. 

-cross_reference 

Generate a cross-reference, if a listing is generated. 

-Dname 

Define name to have the value of 1, to the preprocessor. 

-Vname=val 

Define name to have the value of vol, to the preprocessor. 

-debug 

Add debug data to the object file. Force optimization level to zero. This is 
synonymous with ~g. 

-doublejprecision 

Set all undeclared floating point variables and all declared floating point vari- 
ables to be as if they were declared REAL*8. If they were COMPLEX*8, they are 
then set to COMPLEX*16. -nodoublejprecision is the default. 

-djines 

Compile source file lines with a 'D' or 'd' in column 1. 

-E Run only cpp(l) on the named C programs, and send the result to the standard 
output. 

-extend_source 

Extend the statement field of a source line from columns 1 through 72 to 
columns 1 through 132. 

-fast Perform some optimization which may lose small amounts of precision. 

-full_report 

Produce a detailed vectorizer report. 

-fullsub check 

Generate code to check that every subscript in every array reference is within 
the bounds of the appropriate array dimensions. 

-g Generate additional information needed for the use of dbg(l). Force optimiza- 
tion level to zero. This option is synonymous with -debug. 

-I Suppress the default searching for preprocessor included files in /usr/include. 

-Idir Search for preprocessor include files in dir. Neither -I option affects the Fortran 
INCLUDE statement. 

-i Suppress the automatic production of #ident information. 

-implicit 

Make all variables in a program untyped. 

-include__listing 

List included source files as well as the original source file when generating a 
listing. 

-inline 

Instruct the compiler to enable function inlining. 

-i4 Interpret INTEGER and LOGICAL declarations as if they had been written 
INTEGER*4 and LOGICAL*4. 

-list Generate a listing from the compilation. 

-messages 

Allow warning messages to be printed. 
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-Npaths-namedn I 

Instruct the compiler to make use of the database of functions listed in the cata- ^ 

log nameAn as the source for inlining. 

-no_assoc 

Assume floating point is not associative. Force the floating point operation to 
be in the same order as the program specifies (e.g. no vectorized sum or dot 
product reductions). 

-no_directive 

Do not apply compiler directives. 

-novector 

Not generate no vector code for any loop. This option is especially useful at 
optimization level 03 when you desire parallel code but no vector code. 

-O0 Turn off all optimizations. 

-Ol Perform common subexpression elimination and instruction scheduling. If 
nothing is specified, this -Ol is the default setting of compiler optimization 
level. 

-02 Perform -Ol and vectorization. 

-03 Perform -02 and parallelization. 

-O This is synonymous with -Ol. 

-o filename 

Place the output into filename. 

-object 

Generate object files. 

-onetrip 

Generate code to guarantee that all DO loops execute at least once. This is a 
compatibility feature for programs originally written for use with Fortran 66. 
The default is -noonetrip. 

-P Run only cpp(l) on the named Fortran programs and leave the result in 
corresponding files suffixed .i. This option is passed to cpp(l). 

-p Generate code to profile the loaded program during execution. (See prof (I) and 
mkprofd).) 

-ploop 

Generate code which allows loops within a single routine to be profiled 
separately. 

-r Produce a relocatable output file. 

-S Compile and do not assemble the named Fortran programs, and leave the 
assembler output in corresponding files suffixed .s. 

-safe__strings 

Generate code that corrects for mismatched string parameters. If the type of 
parameters being passed are truly matched, avoid this option because it causes 
some performance degradation. 

-safe=procs 

Cause the compiler to compile a procedure for parallel execution. 

-save 

All variables declared are saved. 



( 
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-standard 

Check for standard Fortran 77 usage. 

-subcheck 

Produce code to check at runtime to ensure that each array element accessed is 
actually part of the appropriate array. However, at optimization level 02 and 
higher, this option ignores the vector mask. This means that some operations 
may generate subscriptranges that are not actually in the code. 

-Uname 

Undefine name. 

-V Prints a single line of version information with the release number of the com- 
pilation system. Version numbers corresponding to the release number of each 
executing component are also printed. Version numbers vary independently of 
each other and of the release number. 

-verbose 

Use verbose message output. 

-vreport 

Invoke the vector reporting facility and tell the user what vectorization has 
been done. A detailed listing is provided for each loop nest and suggestions for 
achieving better performance are included. 

-vsummary 

Invoke the vector reporting facility and tell the user what vectorization has 
been done. Print out what statements are and are not vectorized in each loop. 
This output is in Fortran-like notation. 

-w Suppress warning messages during compilation. 

-yname 

Print uses and definitions of name. 

-43 Cause the compiler to use /usr/lib/bsd/libc.a instead of /usr/lib/libc.a. In another 
word, this option cause the compiler to use BSD library files instead of System 
V library files. 

The fc command recognizes -B hhhhhhh, -D hhhhhhh, -esym, -L, -Ldir, Atag, -m, -n, 
-ofilename, -opct, -p, -r, -s, -T hhhhhhh, -t, -uname, -V, and -yname and passes these 
options and their arguments directly to the loader. See the manual pages for cpp(l) 
and Id (I) for descriptions. 

Other arguments are taken to be Fortran compatible object programs, typically pro- 
duced by an earlier fc run, or perhaps libraries of Fortran compatible routines and are 
passed directly to the link editor. These programs, together with the results of any 
compilations specified, are link edited (in the order given) to produce an executable 
program with name a.out. 



FILES 



file.f Fortran source file 

file.i preprocessed Fortran source file 

file.o object file 

file.s assembly language file 

a.out link edited output 

LIBDIR/ icrtO.o start-up routine 

UBDZR/file.i inlined functions file 
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vector reporting facility file § 



LIBDIR/file.V 

LIBDIR/ file.L listing file 

TMPDIR/* temporary files 

LIBDIR/cpp preprocessor, cpp(l) 

BINDIR/as assembler, as(l) 

BINDIR/ld link editor, Zd(l) 

UBDIR/libc.a standard C library 
LIBDIR is usually /lib 
BINDIR is usually /bin 

TMPDIR is usually /tmp but can be redefined by setting the environment variable 
TMPDIR [see ternpnamQ in tmpnam(3S)], and exporting it to the environment in 
which the programs run. 

ENVIRONMENT VARIABLES 

Setting a couple of shell environment variables to either VMS or BSD allows you to 
decide how files should be read and written. These variables are: 

UNFORMATTEDJO 

UNFORMATTEDJNPUT 

UNFORMATTEDjDUTPUT 

The setting of UNFORMATTEDJO takes precedence over the other two variables. If 
it is set, any setting of UNFORMATTEDJNPUT or UNFORMATTED_OUTPUT is 
ignored. The available settings are described below: 

UNFORMATTEDJNPUT BSD 

On input, the record length is measured in bytes; there is no padding. 

UNFORMATTED JNPUT VMS 
Default. 
On input, the length is in words; padding rounds up to even 4-byte boundaries. 

UNFORMATTED JDUTPUT BSD 

On output, the record length is written in bytes; there is no padding. 

UNFORMATTED_OUTPUT VMS 
Default. 

On output, the record length is written in words (length rounded up to nearest 
4-byte boundary) and padding is up to the nearest 4-byte boundary. 

UNFORMATTEDJO BSD 

On input and output, the record length is both read and written in bytes; there 
is no padding. 

UNFORMATTED JO VMS 
Default. 

On input and output, the record length is read and written in words (rounded 
up to the nearest 4-byte boundary); padding is up to the nearest 4-byte boun- 
dary. 



SEE ALSO 



as(l), ld(l), cpp(l), prof(l), dbg(l) 
Programmer's Guide 
Fortran Reference Manual 
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SEE ALSO 
DIAGNOSTICS 

BUGS 



fgrep - search a file for a character string 

fgrep [options] string [file ...] 

fgrep (fast grep ) seaches files for a character string and prints all lines that contain 
that string, fgrep is different from grep(l) and egrep(l) because it searches for a string, 
instead of searching for a pattern that matches an expression. It uses a fast and com- 
pact algorithm. 

The characters $, *, [, A , I , (, ), and \ are interpreted literally by fgrep, that is, fgrep 
does not recognize full regular expressions as does egrep . Since these characters have 
special meaning to the shell, it is safest to enclose the entire string in single quotes 

If no files are specified, fgrep assumes standard input. Normally, each line found is 
copied to the standard output. The file name is printed before each line found if 
there is more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it was found. This can be 
useful in locating block numbers by context (first block is 0). 

-c Print only a count of the lines that contain the pattern. 

-i Ignore upper/lower case distinction during comparisons. 

-1 Print the names of files with matching lines once, separated by new-lines. 
Does not repeat the names of files when the pattern is found more than once. 

-n Precede each line by its line number in the file (first line is 1). 

-v Print all lines except those that contain the pattern. 

-x Print only lines matched entirely. 

-e special_string 

Search for a special string (string begins with a -). 

-f file Take the list of strings from file . 

ed(l), egrep(l), grep(l), sed(l), sh(l). 

Exit status is if any matches are found, 1 if none, 2 for syntax errors or inaccessible 
files (even if matches were found). 

Ideally there should be only one grep command, but there is not a single algorithm 
that spans a wide enough range of space-time tradeoffs. Lines are limited to BUFSIZ 
characters; longer lines are truncated. BUFSIZ is defined in /usr/include/stdio.h. 
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FILES 
SEE ALSO 



FILE(1) 



file - determine file type 

file [ -c ] [ -f ffile ] [ -m mfile ] arg ... 

file performs a series of tests on each argument in an attempt to classify it. If an argu- 
ment appears to be ASCII, file examines the first 512 bytes and tries to guess its 
language. If an argument is an executable a.out, file will print the version stamp, 
provided it is greater than 0. 

-c The -c option causes file to check the magic file for format errors. This valida- 
tion is not normally carried out for reasons of efficiency. No file typing is done 
under -c. 

-f If the -f option is given, the next argument is taken to be a file containing the 
names of the files to be examined. 

-m The -m option instructs file to use an alternate magic file. 

file uses the file /etc/magic to identify files that have some sort of magic number, that 
is, any file containing a numeric or string constant that indicates its type. Commen- 
tary at the beginning of /etc/magic explains its format. 

/etc/magic 

filehdr(4). 
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find - find files 

find path-name-list expression 

find recursively descends the directory hierarchy for each path name in the path- 
name-list (that is, one or more path names) seeking files that match a boolean expres- 
sion written in the primaries given below. In the descriptions, the argument n is 
used as a decimal integer where +n means more than n, -n means less than n and n 
means exactly n. Valid expressions are: 

-name file True if file matches the current file name. Normal shell argument 

syntax may be used if escaped (watch out for [, ? and *). 

[-perm] -onum True if the file permission flags exactly match the octal number 
onum (see chmodd)). If onum is prefixed by a minus sign, only the 
bits that are set in onum are compared with the file permission 
flags, and the expression evaluates true if they match. 

-type c True if the type of the file is c, where c is b, c, d, 1, p, or f for block 

special file, character special file, directory, symbolic link, fifo (a.k.a 
named pipe), or plain file respectively. 

-links n True if the file has n links. 

-user uname True if the file belongs to the user uname. If uname is numeric and 

does not appear as a login name in the /etc/passwd file, it is taken 
as a user ID. 

-group gnome True if the file belongs to the group gname. If gname is numeric 
and does not appear in the /etc/group file, it is taken as a group ID. 

-size n[c] True if the file is n blocks long (512 bytes per block). If n is fol- 

lowed by a c, the size is in characters. 

-atime n True if the file has been accessed in n days. The access time of 

directories in path-name-list is changed by find itself. 

-mtime n True if the file has been modified in n days. 

-ctime n True if the file has been changed in n days. 

-exec cmd True if the executed cmd returns a zero value as exit status. The 

end of cmd must be punctuated by an escaped semicolon. A com- 
mand argument is replaced by the current path name. 

-ok cmd Like -exec except that the generated command line is printed with 

a question mark first, and is executed only if the user responds by 
typing y. 

-print Always true; causes the current path name to be printed. 

-cpio device Always true; write the current file on device in cpiod) format 

(5120-byte records). 

-newer file True if the current file has been modified more recently than the 

argument file. 

-depth Always true; causes descent of the directory hierarchy to be done 

so that all entries in a directory are acted on before the directory 
itself. This can be useful when find is used with cpiod) to transfer 
files that are contained in directories without write permission. 
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FIND(1) 

-mount Always true; restricts the search to the file system containing the 

directory specified, or if no directory was specified, the current 
directory. 

-local True if the file physically resides on the local system. 

( expression ) True if the parenthesized expression is true (parentheses are spe- 

cial to the shell and must be escaped). 

The primaries may be combined using the following operators (in order of decreas- 
ing precedence): 

1) The negation of a primary (! is the unary not operator). 

2) Concatenation of primaries (the and operation is implied by the juxtaposition of 
two primaries). 

3) Alternation of primaries (-o is the or operator). 

To remove all files named a.out or *.o that have not been accessed for a week: 
find / \( -name a.out -o -name '*.o' \) -atime +7 -exec rm {} \; 

/etc/passwd, /etc/group 

chmod(l), cpio(l), sh(l), test(l), stat(2), umask(2), fs(4). 

find / -depth always fails with the message: 

"find: stat failed: : No such file or directory". 

find does not follow symbolic links to directories. 
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FINGER (1) 



finger - user information lookup program 

finger [ options ] name ... 

By default finger lists the login name, full name, terminal name and write status (as a 
'*' before the terminal name if write permission is denied), idle time, login time, and 
office location and phone number (if they are known) for each current UNIX user. 
(Idle time is minutes if it is a single integer, hours and minutes if a ':' is present, or 
days and hours if a 'd' is present.) 

A longer format also exists and is used by finger whenever a list of people's names is 
given. (Account names as well as first and last names of users are accepted.) This 
format is multi-line, and includes all the information described above as well as the 
user's home directory and login shell, any plan which the person has placed in the 
file .plan in their home directory, and the project on which they are working from the 
file .project also in the home directory. 

Finger may be used to lookup users on a remote machine. The format is to specify 
the user as "user@host." If the user name is left off, the standard format listing is 
provided on the remote machine. 

Finger options include: 

-m Match arguments only on user name. 

-1 Force long output format. 

-p Suppress printing of the .plan files 

-s Force short output format. 



who file 

for users' names, offices, . 

last login times 

plans 

projects 



/etc/utmp 

/etc/passwd 

/usr/adm/lastlog 

-/.plan 

-/.project 

chfn(l),w(l),who(l) 

Earl T. Cohen 



Only the first line of the .project file is printed. 

There is no way to pass arguments to the remote machine as finger uses an internet 
standard port. 
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NAME f 

fold - fold long lines for finite width output device ^ 

SYNOPSIS 

fold [ -width ][ file ... ] 

DESCRIPTION 

Fold is a filter which will fold the contents of the specified files, or the standard input 
if no files are specified, breaking the lines to have maximum width width. The default 
for width is 80. Width should be a multiple of 8 if tabs are present, or the tabs should 
be expanded using expandd) before coming to fold. 

SEE ALSO 

expand(l) 

BUGS 

If underlining is present it may be messed up by folding. 
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fpr, asa - print Fortran file 

fpr 
asa 

fpr (asa) is a filter that transforms files formatted according to Fortran's carriage con- 
trol conventions into files formatted according to UNIX line printer conventions. 

fpr (asa) copies its input onto its output, replacing the carriage control characters with 
characters that produce the intended effects when printed. The first character of each 
line determines the vertical spacing as follows: 



Character 


Vertical Space Before Printing 


Blank 

1 
+ 


One line 

Two lines 

To first line of next page 

No advance 



A blank line is treated as if its first character is a blank. A blank that appears as a car- 
riage control character is deleted. A zero is changed to a newline. A one is changed 
to a form feed. The effects of a "+" are simulated using backspaces. 

a.out I fpr I lp 
a.out I asa I lp 
fpr < fc.output I lp 

Results are undefined for input lines longer than 170 characters. 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 



from - who is my mail from? 

from [ -s sender ] [ user ] 

from prints out the mail header lines in your mailbox file to show you who your mail 
is from. If user is specified, then user's mailbox is examined instead of your own. If 
the -s option is given, then only headers for mail sent by sender are printed. 

/usr/ spool/mail/ * 

biff(l),mail(l) 



c 
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DESCRIPTION 



FSCK(1M) 



f sck - check and repair file systems 

/etc/fsck [-y] [-n] [-sX] [-SX] [-t file] [-q] [-D] [-f] [-b] [file-systems] 

fsck audits and interactively repairs inconsistent conditions for file systems. If the file 
system is found to be consistent, the number of files, blocks used, and blocks free are 
reported. If the file system is inconsistent the user is prompted for concurrence 
before each correction is attempted. It should be noted that some corrective actions 
result in loss of some data. The amount and severity of data loss may be determined 
from the diagnostic output. The default action for each correction is to wait for the 
user to respond yes or no. If the user does not have write permission fsck defaults to 
a -n action. 

The following options are accepted by fsck. 

-y Assume a yes response to all questions asked by fsck. 

-n Assume a no response to all questions asked by fsck; do not open the file sys- 
tem for writing. 

-sX Ignore the actual free list and (unconditionally) reconstruct a new one by 
rewriting the super-block of the file system. The file system should be 
unmounted while this is done; if this is not possible, care should be taken that 
the system is quiescent and that it is rebooted immediately afterwards. This 
precaution is necessary so that the old, bad, in-core copy of the superblock will 
not continue to be used, or written on the file system. 

The -sX option allows for creating an optimal free-list organization. 

If X is not given, the values used when the file system was created are used. 
The format of X is cylinder sizeigap size. 

NOTE: This option has no effect on the Fast File System. 

-SX Conditionally reconstruct the free list. This option is like -sX above except that 
the free list is rebuilt only if there were no discrepancies discovered in the file 
system. Using -S will force a no response to all questions asked by fsck. This 
option is useful for forcing free list reorganization on uncontaminated file sys- 
tems. 

NOTE: This option has no effect on the Fast File System. 

-t If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If 
the -t option is specified, the file named in the next argument is used as the 
scratch file, if needed. Without the -t flag, fsck will prompt the user for the 
name of the scratch file. The file chosen should not be on the file system being 
checked, and if it is not a special file or did not already exist, it is removed 
when fsck completes. 

-q Quiet fsck. Do not print size-check messages. Unreferenced fif os will silently 
be removed. If fsck requires it, counts in the superblock will be automatically 
fixed and the free list salvaged. 

-D Directories are checked for bad blocks. Useful after system crashes. 

-f Fast check. Check block and sizes and check the free list. The free list will be 
reconstructed if it is necessary. 

-b Reboot. If the file system being checked is the root file system and 
modifications have been made, then either remount the root file system or 
reboot the system. A remount is done only if there was minor damage. 
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If no file-systems are specified, fsck will read a list of default file systems from the file | 

/etc/checklist. V 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one i-node or the free list. 

2. Blocks claimed by an i-node or the free list outside the range of the file 
system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 
Directory size not 16-byte aligned. 

5. Bad i-node format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated i-node. 
I-node number out of range. 

8. Super Block checks: 

More than 65536 i-nodes. 

More blocks for i-nodes than there are in the file system. 

9. Bad free block list format. (System V file system only.) 

10. Total free block and/or free i-node count incorrect. 

Orphaned files and directories (allocated but unreferenced) are, with the user's con- 
currence, reconnected by placing them in the lost+f ound directory, if the files are 
nonempty. The user will be notified if the file or directory is empty or not. Empty 
files or directories are removed, as long as the -n option is not specified, fsck will 
force the reconnection of nonempty directories. The name assigned is the i-node ^ 

number. The only restriction is that the directory lost+f ound must preexist in the | 

root of the file system being checked and must have empty slots in which entries can ^ 

be made. This is accomplished by making lost+f ound, copying a number of files to 
the directory, and then removing them (before fsck is executed). 

Checking the raw device is almost always faster and should be used with everything 
but the root file system. 



FILES 
SEE ALSO 
BUGS 



WARNING Do not use the raw device on the root file system or serious damage to 
the file system will result. 

/etc/ checklist contains default list of file systems to check. 

checklist^), crash(lM), fs(4), mkfs(lM), ncheck(lM), uadmin(2). 

I-node numbers for . and ... in each directory are not checked for validity. 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



FSDB(1M) 



fsdb - file system debugger 

/etc/fsdb special [ - ] 

fsdb can be used to patch up a damaged file system after a crash. It has conversions 
to translate block and i-numbers into their corresponding disk addresses. Also 
included are mnemonic offsets to access different parts of an i-node. These greatly 
simplify the process of correcting control block entries or descending the file system 
tree. 

fsdb automatically determines the type of file system you are trying to repair and 
invokes the appropriate module: 

fsdb.s54k 

to repair System V file systems 

fsdb.affs 

to repair Ardent Fast File Systems 

fsdb contains several error-checking routines to verify i-node and block addresses. 
These can be disabled if necessary by invoking fsdb with the optional - argument or 
by the use of the O symbol, (fsdb reads the i-size and f-size entries from the super- 
block of the file system as the basis for these checks.) 

Numbers are considered decimal by default. Octal numbers must be prefixed with a 
zero. During any assignment operation, numbers are checked for a possible trunca- 
tion error due to a size mismatch between source and destination. 

fsdb reads a block at a time and will therefore work with raw as well as block I/O. A 
buffer management routine is used to retain commonly used blocks of data in order 
to reduce the number of read system calls. All assignment operations result in an 
immediate write-through of the corresponding block. 

The symbols recognized by fsdb are: 
absolute address 

convert from i-number to i-node address 
convert to block address 
directory slot offset 

extent slot offset (only available for the Ardent Fast File System) 
address arithmetic 
quit 

save, restore an address 
numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking flip flop 
general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 

The print facilities generate a formatted output in various styles. The current address 
is normalized to an appropriate boundary before printing begins. It advances with 
the printing and is left at the address of the last item printed. The output can be 



# 
i 
b 
d 
e 
+ - 

q 
>/< 



o 

p 
f 

B 

W 
D 

f 
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terminated at any time by typing the delete character. If a number follows the p m 

symbol, that many entries are printed. A check is made to detect block boundary ^ 

overflows since logically sequential blocks are generally not physically sequential. If 
a count of zero is used, all entries to the end of the current block are printed. The 
print options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

x print as hexadecimal bytes 

The f symbol is used to print data blocks associated with the current i-node. If fol- 
lowed by a number, that block of the file is printed. (Blocks are numbered from 
zero.) The desired print option letter follows the block number, if present, or the f 
symbol. This print facility works for small as well as large files. It checks for special 
devices and that the block pointers used to find the data are not zero. 

Dots, tabs, and spaces may be used as function delimiters but are not necessary. A 

line with just a new-line character will increment the current address by the size of 

the data type last printed. That is, the address is set to the next byte, word, double 

word, directory entry or i-node, allowing the user to step through a region of a file 

system. Information is printed in a format appropriate to the data type. Bytes, 

words and double words are displayed with the octal address followed by the value 

in octal and decimal. A ,B or .D is appended to the address for byte and double 

word values, respectively. Directories are printed as a directory slot offset followed 

by the decimal i-number and the character representation of the entry name. I-nodes £ 

are printed with labeled fields describing each element. V 

The following mnemonics are used for i-node examination and refer to the current 
working i-node: 

md mode 

In link count 

uid user ID number 

gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 



EXAMPLES 



386i prints i-number 386 in an i-node format. This now becomes the 

current working i-node. 

ln=4 changes the link count for the working i-node to 4. 

ln=+l increments the link count by 1 . 

fc prints, in ASCII, block zero of the file associated with the working 

i-node. 

2i.fd prints the first 32 directory entries for the root i-node of this file 

system. 



( 
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d5i.fc 

512B.p0o 
2i.a0b.d7=3 

d7.nm="name" 

a2b.p0d 
eOb.pOx 



changes the current i-node to that associated with the 5th directory 
entry (numbered from zero) found from the above command. The 
first logical block of the file is then printed in ASCII. 

prints the superblock of this file system in octal. 

changes the i-number for the seventh directory slot in the root 
directory to 3. This example also shows how several operations 
can be combined on one command line. 

changes the name field in the directory slot to the given string. 
Quotes are optional when used with nm if the first character is 
alphabetic. 

prints the third block of the current i-node as directory entries. 

prints the first block of the current extent (for an Ardent Fast File 
System) in hexadecimal format 



SEE ALSO 



dir(4), fs(4), fsck(lM) 
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NAME 

SYNOPSIS 

DESCRIPTION 



DIAGNOSTICS 

AUTHOR 
BUGS 



FSPLIT(1) 



f split - split a multi-routine Fortran file into individual files 

fsplit [ -e efile] ... [ file ] 

f split takes as input either a file or standard input containing Fortran source code. It 
attempts to split the input into separate routine files of the form name.f, where name is 
the name of the program unit (e.g. function, subroutine, block data or program). The 
name for unnamed block data subprograms has the form blkdtaNNN.f where NNN is 
three digits and a file of this name does not already exist. For unnamed main pro- 
grams the name has the form mainNNN.f. If there is an error in classifying a program 
unit, or if name.f already exists, the program unit will be put in a file of the form 
zzzNNN.f where zzzNNN.f does not already exist. 

Normally each subprogram unit is split into a separate file. When the -e option is 
used, only the specified subprogram units are split into separate files. E.g.: 

fsplit -e readit -e doit prog.f 

will split readit and doit subprograms into separate files. 

If names specified via the -e option are not found, a diagnostic is written to standard 
error. 

Asa Romberger and Jerry Berkman 

Fsplit assumes the subprogram name is on the first noncomment line of the subpro- 
gram unit. Nonstandard source formats may confuse fsplit. 

It is hard to use -e for unnamed main programs and block data subprograms since 
you must predict the created file name. 



C 
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NAME 

SYNOPSIS 

DESCRIPTION 



FSSTAT(1M) 



f sstat - report file system status 



/etc/fsstat special_file 



SEE ALSO 
DIAGNOSTICS 



BUGS 



fssiat reports on the status of the file system on special Jile . During startup, this com- 
mand is used to determine if the file system needs checking before it is mounted. 
fsstat succeeds if the file system is unmounted and appears okay. For the root file 
system, it succeeds if the file system is active and not marked bad. 



fs(4). 



The command has the following exit codes: 

- the file system is not mounted and appears okay, 

(except for root where means mounted and okay). 

1 - the file system is not mounted and needs to be checked. 

2 - the file system is mounted. 

3 - the command failed. 



Does not work with the Fast File System. 
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NAME 

SYNOPSIS 

DESCRIPTION 



WARNING 
SEE ALSO 
BUGS 



FSTYP(1M) 



f styp - determine file system identifier 

fstyp special 

fstyp allows the user to determine the file system identifier of mounted or 
unmounted file systems using heuristic programs. The file system type is required by 
mountdD and sometimes by mountilM) to mount file systems of different types. 

The directory /ete/fstyp.d contains a program for each file system type to be checked; 
each of these programs applies some appropriate heuristic to determine whether the 
supplied special file is of the type for which it checks. If it is, the program prints on 
standard output the usual file-system identifier for that type and exits with a return 
code of 0; otherwise it prints error messages on standard error and exits with a non- 
zero return code, fstyp runs the programs in /etc/fstyp.d in alphabetical order, pass- 
ing special as an argument; if any program succeeds, its file-system type identifier is 
printed and fstyp exits immediately. If no program succeeds, fstyp prints 
"Unknown_fstyp" to indicate failure. 

The use of heuristics implies that the result of fstyp is not guaranteed to be accurate. 

mount(lM), mount(2), sysfs(2). 

Does not work with the Fast File System. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FTP(1C) 



ftp - ARPANET file transfer program 

ftp [-v][-d][~i][-n][-g] [host] 

Ftp is the user interface to the ARPANET standard File Transfer Protocol. The pro- 
gram allows a user to transfer files to and from a remote network site. 

The client host with which ftp is to communicate may be specified on the command 
line. If this is done, ftp will immediately attempt to establish a connection to an FTP 
server on that host; otherwise, ftp will enter its command interpreter and await 
instructions from the user. When ftp is awaiting commands from the user the 
prompt "ftp>" is provided to the user. The following commands are recognized by 
ftp: 

! [ command [ args ] ] 

Invoke an interactive shell on the local machine. If there are arguments, the 
first is taken to be a command to execute directly, with the rest of the argu- 
ments as its arguments. 

$ macro-name [ args ] 

Execute the macro macro-name that was defined with the macdef command. 
Arguments are passed to the macro unglobbed. 

account [ passwd ] 

Supply a supplemental password required by a remote system for access to 
resources once a login has been successfully completed. If no argument is 
included, the user will be prompted for an account password in a non-echoing 
input mode. 

append local-file [ remote-file ] 

Append a local file to a file on the remote machine. If remote-file is left 
unspecified, the local file name is used in naming the remote file after being 
altered by any ntrans or nmap setting. File transfer uses the current settings for 
type, format, mode, and structure. 

ascii Set the file transfer type to network ASCII. This is the default type. 

bell Arrange that a bell be sounded after each file transfer command is completed. 

binary 

Set the file transfer type to support binary image transfer. 

bye Terminate the FTP session with the remote server and exit ftp. An end of file 
will also terminate the session and exit. 

case Toggle remote computer file name case mapping during mget commands. 
When case is on (default is off), remote computer file names with all letters in 
upper case are written in the local directory with the letters mapped to lower 
case. 

cd remote-directory 

Change the working directory on the remote machine to remote-directory. 

cdup 

Change the remote machine working directory to the parent of the current 
remote machine working directory. 

close 

Terminate the FTP session with the remote server, and return to the command 
interpreter. Any defined macros are erased. 
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cr 



( 



Toggle carriage return stripping during ascii type file retrieval. Records are I 

denoted by a carriage return/linefeed sequence during ascii type file transfer. ^ 

When cr is on (the default), carriage returns are stripped from this sequence to 
conform with the UNIX single linefeed record delimiter. Records on non-UNIX 
remote systems may contain single linefeeds; when an ascii type transfer is 
made, these linefeeds may be distinguished from a record delimiter only when 
crisoff. 

delete remote-file 

Delete the file remote-file on the remote machine. 

debug [ debug-value ] 

Toggle debugging mode. If an optional debug-value is specified it is used to set 
the debugging level. When debugging is on, ftp prints each command sent to 
the remote machine, preceded by the string "->". 

dir [ remote-directory ] [ local-file ] 

Print a listing of the directory contents in the directory, remote-directory, and, 
optionally, placing the output in local-file. If no directory is specified, the 
current working directory on the remote machine is used. If no local file is 
specified, or local-file is -, output comes to the terminal. 

disconnect 

A synonym for close. 

form format 

Set the file transfer form to format. The default format is "file". 

get remote-file [ local-file ] 

Retrieve the remote-file and store it on the local machine. If the local file name is 
not specified, it is given the same name it has on the remote machine, subject to 
alteration by the current case, ntrans, and nmap settings. The current settings 
for type, form, mode, and structure are used while transferring the file. 

glob Toggle filename expansion for mdelete, mget and mput If globbing is turned 
off with glob, the file name arguments are taken literally and not expanded. 
Globbing for mput is done as in csh(l). For mdelete and mget, each remote file 
name is expanded separately on the remote machine and the lists are not 
merged. Expansion of a directory name is likely to be different from expansion 
of the name of an ordinary file: the exact result depends on the foreign operat- 
ing system and ftp server, and can be previewed by doing 'mis remote-files -'. 
Note: mget and mput are not meant to transfer entire directory subtrees of 
files. That can be done by transferring a tar(l) archive of the subtree (in binary 
mode). 

hash Toggle hash-sign ("#") printing for each data block transferred. The size of a 
data block is 1024 bytes. 

help [ command ] 

Print an informative message about the meaning of command . If no argument is 
given, ftp prints a list of the known commands. 

led [directory] 

Change the working directory on the local machine. If no directory is specified, 
the user's home directory is used. 

Is [ remote-directory ] [ local-file ] 

Print an abbreviated listing of the contents of a directory on the remote 
machine. If remote-directory is left unspecified, the current working directory is 
used. If no local file is specified, or if local-file is -, the output is sent to the ter- 
minal. 
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macdef macro-name 

Define a macro. Subsequent lines are stored as the macro macro-name; a null 
line (consecutive newline characters in a file or carriage returns from the termi- 
nal) terminates macro input mode. There is a limit of 16 macros and 4096 total 
characters in all defined macros. Macros remain defined until a close com- 
mand is executed. The macro processor interprets '$' and 'V as special charac- 
ters. A '$' followed by a number (or numbers) is replaced by the corresponding 
argument on the macro invocation command line. A '$' followed by an '¥ sig- 
nals that macro processor that the executing macro is to be looped. On the first 
pass '$i' is replaced by the first argument on the macro invocation command 
line, on the second pass it is replaced by the second argument, and so on. A ' V 
followed by any character is replaced by that character. Use the 'V to prevent 
special treatment of the '$'. 

mdelete [ remote-files ] 

Delete the remote-files on the remote machine. 

mdir remote-files local-file 

Like dir, except multiple remote files may be specified. If interactive prompt- 
ing is on, ftp will prompt the user to verify that the last argument is indeed the 
target local file for receiving mdir output. 

mget remote-files 

Expand the remote-files on the remote machine and do a get for each file name 
thus produced. See glob for details on the filename expansion. Resulting file 
names will then be processed according to case, ntrans, and nmap settings. Files 
are transferred into the local working directory, which can be changed with 
'led directory'; new local directories can be created with '! mkdir directory'. 

mkdir directory-name 

Make a directory on the remote machine. 

mis remote-files local-file 

Like Is, except multiple remote files may be specified. If interactive prompting 
is on, ftp will prompt the user to verify that the last argument is indeed the tar- 
get local file for receiving mis output. 

mode [ mode-name ] 

Set the file transfer mode to mode-name. The default mode is "stream" mode. 

mput local-files 

Expand wild cards in the list of local files given as arguments and do a put for 
each file in the resulting list. See glob for details of filename expansion. Result- 
ing file names will then be processed according to ntrans and nmap settings. 

nmap [ inpattern outpattern ] 

Set or unset the filename mapping mechanism. If no arguments are specified, 
the filename mapping mechanism is unset. If arguments are specified, remote 
filenames are mapped during mput commands and put commands issued 
without a specified remote target filename. If arguments are specified, local 
filenames are mapped during mget commands and get commands issued 
without a specified local target filename. This command is useful when con- 
necting to a non-UNIX remote computer with different file naming conventions 
or practices. The mapping follows the pattern set by inpattern and outpattern. 
Inpattern is a template for incoming filenames (which may have already been 
processed according to the ntrans and case settings). Variable templating is 
accomplished by including the sequences '$1', '$2', ..., '$9' in inpattern. Use 'V 
to prevent this special treatment of the '$' character. All other characters are 
treated literally, and are used to determine the nmap inpattern variable values. 
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For exmaple, given inpattern $1.$2 and the remote file name "mydata.data", $1 | 

would have the value "mydata", and $2 would have the value "data". The out- ^ 

pattern determines the resulting mapped filename. The sequences '$1', '$2', ...., 
'$9' are replaced by any value resulting from the inpattern template. The 
sequence '$Q' is replace by the original filename. Additionally, the sequence 
'[seqlpeql]' is replaced by seql if seql is not a null string; otherwise it is replaced 
by seql. For example, the command "nmap $1.$2.$3 [$l,$2].[$2,file]" would 
yield the output filename "myfile.data" for input filenames "myfile.data" and 
"myfile.data.old", "myfile.file" for the input filename "myfile", and 
"myfile.myfile" for the input filename ".myfile". Spaces may be included in out- 
pattern, as in the example: nmap $1 I sed "s/ *$//" > $1 . Use the 'V character 
to prevent special treatment of the '$', '[', ']', and ',' characters. 

ntrans [ inchars [ outchars ] ] 

Set or unset the filename character translation mechanism. If no arguments are 
specified, the filename character translation mechanism is unset. If arguments 
are specified, characters in remote filenames are translated during mput com- 
mands and put commands issued without a specified remote target filename. 
If arguments are specified, characters in local filenames are translated during 
mget commands and get commands issued without a specified local target 
filename. This command is useful when connecting to a non-UNIX remote 
computer with different file naming conventions or practices. Characters in a 
filename matching a character in inchars are replaced with the corresponding 
character in outchars. If the character's position in inchars is longer than the 
length of outchars, the character is deleted from the file name. 

open host [ port ] 

Establish a connection to the specified host FTP server. An optional port I 

number may be supplied, in which case, ftp will attempt to contact an FTP V 

server at that port. If the auto-login option is on (default), ftp will also attempt 
to automatically log the user in to the FTP server (see below). 

prompt 

Toggle interactive prompting. Interactive prompting occurs during multiple 
file transfers to allow the user to selectively retrieve or store files. If prompting 
is turned off (default is on), any mget or mput will transfer all files, and any 
mdelete will delete all files. 

proxy ftp-command 

Execute an ftp command on a secondary control connection. This command 
allows simultaneous connection to two remote ftp servers for transferring files 
between the two servers. The first proxy command should be an open, to 
establish the secondary control connection. Enter the command "proxy ?" to see 
other ftp commands executable on the secondary connection. The following 
commands behave differently when prefaced by proxy: open will not define 
new macros during the auto-login process, close will not erase existing macro 
definitions, get and mget transfer files from the host on the primary control 
connection to the host on the secondary control connection, and put, mput, and 
append transfer files from the host on the secondary control connection to the 
host on the primary control connection. Third party file transfers depend upon 
support of the ftp protocol PASV command by the server on the secondary con- 
trol connection. 



put local-file [ remote-file ] 

Store a local file on the remote machine. If remote-file is left unspecified, the 
local file name is used after processing according to any ntrans or nmap settings 
in naming the remote file. File transfer uses the current settings for type, format, 



192 Stardent 1500/3000 



( 



FTP(1C) FTP(1C) 

mode, and structure. 

pwd Print the name of the current working directory on the remote machine. 

quit A synonym for bye. 

quote argl argl ... 

The arguments specified are sent, verbatim, to the remote FTP server. 

recv remote-file [ local-file ] 
A synonym for get. 

remotehelp [ command-name ] 

Request help from the remote FTP server. If a command-name is specified it is 
supplied to the server as well. 

rename [ from ][to] 

Rename the file from on the remote machine, to the file to. 

reset Clear reply queue. This command re-synchronizes command/reply sequenc- 
ing with the remote ftp server. Resynchronization may be neccesary following 
a violation of the ftp protocol by the remote server. 

rmdir directory-name 

Delete a directory on the remote machine. 

runique 

Toggle storing of files on the local system with unique filenames. If a file 
already exists with a name equal to the target local filename for a get or mget 
command, a ".1" is appended to the name. If the resulting name matches 
another existing file, a ".2" is appended to the original name. If this process 
continues up to ".99", an error message is printed, and the transfer does not take 
place. The generated unique filename will be reported. Note that runique will 
not affect local files generated from a shell command (see below). The default 
value is off. 



send local-file [ remote-file ] 
A synonym for put. 



sendport 

Toggle the use of PORT commands. By default, ftp will attempt to use a PORT 
command when establishing a connection for each data transfer. The use of 
PORT commands can prevent delays when performing multiple file transfers. If 
the PORT command fails, ftp will use the default data port. When the use of 
PORT commands is disabled, no attempt will be made to use PORT commands 
for each data transfer. This is useful for certain FTP implementations which do 
ignore PORT commands but, incorrectly, indicate they've been accepted. 

status 

Show the current status of ftp. 

struct [ struct-name ] 

Set the file transfer structure to struct-name. By default "stream" structure is 
used. 

sunique 

Toggle storing of files on remote machine under unique file names. Remote ftp 
server must support ftp protocol STOU command for successful completion. 
The remote server will report unique name. Default value is off. 

tenex 

Set the file transfer type to that needed to talk to TENEX machines. 
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trace Toggle packet tracing. I 

type [ type-name] 

Set the file transfer type to type-name. If no type is specified, the current type is 
printed. The default type is network ASCII. 

user user-name { password ] [ account ] 

Identify yourself to the remote FTP server. If the password is not specified and 
the server requires it, ftp will prompt the user for it (after disabling local echo). 
If an account field is not specified, and the FTP server requires it, the user will 
be prompted for it. If an account field is specified, an account command will be 
relayed to the remote server after the login sequence is completed if the remote 
server did not require it for logging in. Unless ftp is invoked with "auto-login" 
disabled, this process is done automatically on initial connection to the FTP 
server. 

verbose 

Toggle verbose mode. In verbose mode, all responses from the FTP server are 
displayed to the user. In addition, if verbose is on, when a file transfer com- 
pletes, statistics regarding the efficiency of the transfer are reported. By 
default, verbose is on. 

? [ command ] 

A synonym for help. 

Command arguments which have embedded spaces may be quoted with quote (") 
marks. 

ABORTING A FILE TRANSFER 

To abort a file transfer, use the terminal interrupt key (usually Ctrl-C). Sending 
transfers will be immediately halted. Receiving transfers will be halted by sending a 
ftp protocol ABOR command to the remote server, and discarding any further data 
received. The speed at which this is accomplished depends upon the remote server's 
support for ABOR processing. If the remote server does not support the ABOR com- 
mand, an "ftp>" prompt will not appear until the remote server has completed send- 
ing the requested file. 

The terminal interrupt key sequence will be ignored when ftp has completed any 
local processing and is awaiting a reply from the remote server. A long delay in this 
mode may result from the ABOR processing described above, or from unexpected 
behavior by the remote server, including violations of the ftp protocol. If the delay 
results from unexpected remote server behavior, the local ftp program must be killed 
by hand. 

FILE NAMING CONVENTIONS 

Files specified as arguments to ftp commands are processed according to the follow- 
ing rules. 

1) If the file name "-" is specified, the stdin (for reading) or stdout (for writing) is 
used. 

2) If the first character of the file name is " I ", the remainder of the argument is 
interpreted as a shell command. Ftp then forks a shell, using popenQ) with the 
argument supplied, and reads (writes) from the stdout (stdin). If the shell com- 
mand includes spaces, the argument must be quoted; e.g. "" I Is -It"". A partic- 
ularly useful example of this mechanism is: "dir I more". 

3) Failing the above checks, if "globbing" is enabled, local file names are 
expanded according to the rules used in the csh(l); ci. the glob command. If the t 
ftp command expects a single local file ( .e.g. put), only the first filename gen- V. 
erated by the "globbing" operation is used. 
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4) For mget commands and get commands with unspecified local file names, the 
local filename is the remote filename, which may be altered by a case, ntrans, or 
nmap setting. The resulting filename may then be altered if runique is on. 

5) For mput commands and put commands with unspecified remote file names, 
the remote filename is the local filename, which may be altered by a ntrans or 
nmap setting. The resulting filename may then be altered by the remote server 
if sunique is on. 

FILE TRANSFER PARAMETERS 

The FTP specification specifies many parameters which may affect a file transfer. The 
type may be one of "ascii", "image" (binary), "ebcdic", and 'local byte size" (for 
PDP-10's and PDP-20's mostly). Ftp supports the ascii and image types of file 
transfer, plus local byte size 8 for tenex mode transfers. 

Ftp supports only the default values for the remaining file transfer parameters: mode, 
form, and struct. 



OPTIONS 



THE .netrc FILE 



Options may be specified at the command line, or to the command interpreter. 

The ~v (verbose on) option forces ftp to show all responses from the remote server, as 
well as report on data transfer statistics. 

The -n option restrains ftp from attempting "auto-login" upon initial connection. If 

auto-login is enabled, ftp will check the .netrc (see below) file in the user's home 

directory for an entry describing an account on the remote machine. If no entry 

exists, ftp will prompt for the remote machine login name (default is the user identity 

on the local machine), and, if necessary, prompt for a password and an account with 

which to login. 

The -i option turns off interactive prompting during multiple file transfers. 

The -d option enables debugging. 

The -g option disables file name globbing. 

The .netrc file contains login and initialization information used by the auto-login 
process. It resides in the user's home directory. The following tokens are recog- 
nized; they may be separated by spaces, tabs, or new-lines: 

machine name 

Identify a remote machine name. The auto-login process searches the .netrc file 
for a machine token that matches the remote machine specified on the ftp com- 
mand line or as an open command argument. Once a match is made, the sub- 
sequent .netrc tokens are processed, stopping when the end of file is reached or 
another machine token is encountered. 

login name 

Identify a user on the remote machine. If this token is present, the auto-login 
process will initiate a login using the specified name. 

password string 

Supply a password. If this token is present, the auto-login process will supply 
the specified string if the remote server requires a password as part of the login 
process. Note that if this token is present in the .netrc file, ftp will abort the 
auto-login process if the .netrc is readable by anyone besides the user. 

account string 

Supply an additional account password. If this token is present, the auto-login 
process will supply the specified string if the remote server requires an 
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additional account password, or the auto-login process will initiate an ACCT I 

command if it does not. 

macdef name 

Define a macro. This token functions like the ftp macdef command functions. 
A macro is defined with the specified name; its contents begin with the next 
.netrc line and continue until a null line (consecutive new-line characters) is 
encountered. If a macro named init is defined, it is automatically executed as 
the last step in the auto-login process. 

BUGS 

Correct execution of many commands depends upon proper behavior by the remote 
server. 

An error in the treatment of carriage returns in the 4.2BSD UNIX ascii-mode transfer 
code has been corrected. This correction may result in incorrect transfers of binary 
files to and from 4.2BSD servers using the ascii type. Avoid this problem by using 
the binary image type. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



FUSER(TM) 



fuser - identify processes using a file or file structure 

/etc/fuser [-ku] files I resources [-] [[-ku] files I resources] 

fuser outputs the process IDs of the processes that are using the files specified as argu- 
ments. Each process ID is followed by a letter code, interpreted as follows: if the pro- 
cess is using the file as 1) its current directory, the code is c, 2) the parent of its 
current directory (only when the file is being used by the system), the code is p, or 3) 
its root directory, the code is r. For block special devices with mounted file systems, 
all processes using any file on that device are listed. For all other types of files (text 
files, executables, directories, devices, etc.) only the processes using that file are 
reported. 

The following options may be used with fuser: 

-u the user login name, in parentheses, also follows the process ID. 

-k the SIGKILL signal is sent to each process. Since this option spawns kills for 
each process, the kill messages may not show up immediately [see kill(2)]. 

If more than one group of files are specified, the options may be respecified for each 
additional group of files. A lone dash cancels the options currently in force; then, the 
new set of options applies to the next group of files. 

The process IDs are printed as a single line on the standard output, separated by 
spaces and terminated with a single new line. All other output is written on stan- 
dard error. 

Any user with permission to read /dev/kmem and /dev/mem can use fuser. Only the 
super-user can terminate another user's process 

/unix for system namelist 

/dev/kmem for system image 
/dev/mem also for system image 

kill(2), mount(lM), ps(l), signal(2). 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



FWTMP(1M) 



fwtmp, wtmpfix - manipulate connect accounting records 

/usr/lib/acct/fwtmp [-ic] 
/usr/lib/acct/wtmpfix [files] 

fwtmp reads from the standard input and writes to the standard output, converting 
binary records of the type found in wtmp to formatted ASCII records. The ASCII ver- 
sion is useful to enable editing, via ed(l), bad records or general purpose mainte- 
nance of the file. 

The argument -ic is used to denote that input is in ASCII form, and output is to be 
written in binary form. 

wtmpfix examines the standard input or named files in wtmp format, corrects the 
time /date stamps to make the entries consistent, and writes to the standard output. 
A - can be used in place of files to indicate the standard input. If time/date correc- 
tions are not performed, acctcon(l) will fault when it encounters certain date-change 
records. 

Each time the date is set, a pair of date change records are written to /etc/wtmp. The 
first record is the old date denoted by the string old time placed in the line field and 
the flag OLDJTIME placed in the type field of the <utmp.h> structure. The second 
record specifies the new date and is denoted by the string new time placed in the line 
field and the flag NEWJTIME placed in the type field, wtmpfix uses these records to 
synchronize all time stamps in the file. 

In addition to correcting time/date stamps, wtmpfix will check the validity of the 
name field to ensure that it consists solely of alphanumeric characters or spaces. If it 
encounters a name that is considered invalid, it will change the login name to 
INVALID and write a diagnostic to the standard error. In this way, wtmpfix reduces 
the chance that acctcond) will fail when processing connect accounting records. 

/etc/wtmp 
/usr/include/utmp.h 

acct(lM), acct(2), acct(4), acctcms(lM), acctcom(l), acctcond M), acctmerg(lM), 
acctprc(lM), acctsh(lM), ed(l), runacct(lM), utmp(4) 
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NAME 
SYNOPSIS 

DESCRIPTION 



GET(1) 



get - get a version of an SCCS file 

get [-rSID] [-ccutoff] [-ilist] [-xlist] [-wstring] [-aseq-no.] [-k] [-e] [-l[p] [-p] [-m] 
[-n] [-s] [-b] [-g] [-t] file ... 

get generates an ASCII text file from each named SCCS file according to the 
specifications given by its keyletter arguments, which begin with -. The arguments 
may be specified in any order, but all keyletter arguments apply to all named SCCS 
files. If a directory is named, get behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a name of - is 
given, the standard input is read; each line of the standard input is taken to be the 
name of an SCCS file to be processed. Again, non-SCCS files and unreadable files are 
silently ignored. 

The generated text is normally written into a file called the g-file whose name is 
derived from the SCCS file name by simply removing the leading s.; (see also FILES, 
below). 

Each of the keyletter arguments is explained below as though only one SCCS file is to 
be processed, but the effects of any keyletter argument applies independently to each 
named file. 

-rSID The SCCS ID entification string (SID) of the version (delta) of an 

SCCS file to be retrieved. Table~l below shows, for the most useful 
cases, what version of an SCCS file is retrieved (as well as the SID of 
the version to be eventually created by deltaiX) if the -e keyletter is 
also used), as a function of the SID specified. 

-ccutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after the 
specified cutoff date-time are included in the generated ASCII text 
file. Units omitted from the date-time default to their maximum 
possible values; that is, -c7502 is equivalent to -c750228235959. Any 
number of non-numeric characters may separate the various 2-digit 
pieces of the cutoff date-time. This feature allows one to specify a 
cufo/f date in the form: n -c77/2/2 9:22:25". Note that this implies that 
one may use the %E% and %U% identification keywords (see 
below) for nested gets within, say the input to a send (1C) command: 

~!get "-c%E% %U%" s.file 

-ilist A list of deltas to be included (forced to be applied) in the creation 

of the generated file. The list has the following syntax: 

<list> ::= <range> | <list> , <range> 
<range> ::= SID | SID - SID 

SID, the SCCS Identification of a delta, may be in any form shown in 
the "SID Specified" column of Table 1. 

-xlist A list of deltas to be excluded in the creation of the generated file. 

See the -i keyletter for the list format. 



Stardent 1500/3000 



199 



Source Code Control System Utilities 



G£T(1) GET(1) 



-e 



Indicates that the get is for the purpose of editing or making a I 

change (delta) to the SCCS file via a subsequent use of delta(l). The 
-e keyletter used in a get for a particular version (SID) of the SCCS 
file prevents further gets for editing on the same SID until delta is 
executed or the j (joint edit) flag is set in the SCCS file [see admin(l)]. 
Concurrent use of get -e for different SIDs is always allowed. 

If the g-file generated by get with an -e keyletter is accidentally 
ruined in the process of editing it, it may be regenerated by re- 
executing the get command with the -k keyletter in place of the -e 
keyletter. 

SCCS file protection specified via the ceiling, floor, and authorized 
user list stored in the SCCS file [see admind)] are enforced when the 
-e keyletter is used. 

-b Used with the -e keyletter to indicate that the new delta should 

have an SID in a new branch as shown in Table 1. This keyletter is 
ignored if the b flag is not present in the file [see admin{\)\ or if the 
retrieved delta is not a leaf delta. (A leaf delta is one that has no suc- 
cessors on the SCCS file tree.) 

Note: A branch delta may always be created from a non-leaf delta. 
Partial SIDs are interpreted as shown in the "SID Retrieved" column 
of Table 1. 



-k Suppresses replacement of identification keywords (see below) in 

the retrieved text by their value. The -k keyletter is implied by the 
-e keyletter. 

-l[p] Causes a delta summary to be written into an l-file. If -Ip is used 

then an l-file is not created; the delta summary is written on the 
standard output instead. See FILES for the format of the l-file. 

-p Causes the text retrieved from the SCCS file to be written on the 

standard output. No g-file is created. All output which normally 
goes to the standard output goes to file descriptor 2 instead, unless 
the -s keyletter is used, in which case it disappears. 

-s Suppresses all output normally written on the standard output. 

However, fatal error messages (which always go to file descriptor 2) 
remain unaffected. 

-m Causes each text line retrieved from the SCCS file to be preceded by 

the SID of the delta that inserted the text line in the SCCS file. The 
format is: SID, followed by a horizontal tab, followed by the text 
line. 

-n Causes each generated text line to be preceded with the %M% 

identification keyword value (see below). The format is: %M% 
value, followed by a horizontal tab, followed by the text line. When 
both the -m and -n keyletters are used, the format is: %M% value, 
followed by a horizontal tab, followed by the -m keyletter gen- 
erated format. 

-g Suppresses the actual retrieval of text from the SCCS file. It is pri- 

marily used to generate an l-file, or to verify the existence of a par- 
ticular SID. 

-t Used to access the most recently created delta in a given release 

(e.g., -rl), or release and level (e.g., -rl.2). 
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-w string Substitute string for all occurrences of %W% when getting the file. 

-aseq-no. The delta sequence number of the SCCS file delta (version) to be 
retrieved [see sccsfile(5)]. This keyletter is used by the comb(X) com- 
mand; it is not a generally useful keyletter. If both the -r and -a 
keyletters are specified, only the -a keyletter is used. Care should 
be taken when using the -a keyletter in conjunction with the -e 
keyletter, as the SID of the delta to be created may not be what one 
expects. The -r keyletter can be used with the -a and -e keyletters 
to control the naming of the SID of the delta to be created. 

For each file processed, get responds (on the standard output) with the SID being 
accessed and with the number of lines retrieved from the SCCS file. 

If the -e keyletter is used, the SID of the delta to be made appears after the SID 
accessed and before the number of lines generated. If there is more than one named 
file or if a directory or standard input is named, each file name is printed (preceded 
by a new-line) before it is processed. If the -i keyletter is used included deltas are 
listed following the notation "Included"; if the -x keyletter is used, excluded deltas 
are listed following the notation "Excluded". 

TABLE 1. Determination of SCCS Identification String 



SID* 
Specified 


-b Keyletter 
Usedt 


Other 
Conditions 


SID 
Retrieved 


SID of Delta 
to be Created 


nonej 


no 


R defaults to mR 


mR.mL 


mR.(mL+l) 


nonet 


yes 


R defaults to mR 


mR.mL 


mR.mL.(mB+l).l 


R 


no 


R>mR 


mR.mL 


R.l*** 


R 


no 


R = mR 


mR.mL 


mR.(mL+l) 


R 


yes 


R>mR 


mR.mL 


mR.mL.(mB+l).l 


R 


yes 


R = mR 


mR.mL 


mR.mL.(mB+l).l 


R 


- 


R < mR and 

R does not exist 


hR.mL** 


hR.mL.(mB+l).l 


R 


- 


Trunk succ.# 
in release > R 
and R exists 


R.mL 


R.mL.(mB+l).l 


R.L 


no 


No trunk succ. 


R.L 


R.(L+1) 


R.L 


yes 


No trunk succ. 


R.L 


R.L.(mB+l).l 


R.L 


- 


Trunk succ. 
in release > R 


R.L 


R.L.(mB+l).l 


R.L.B 


no 


No branch succ. 


R.L.B.mS 


R.L.B.(mS+l) 


RX.B 


yes 


No branch succ. 


R.L.B.mS 


R.L.(mB+l).l 


R.L.B.S 


no 


No branch succ. 


R.L.B.S 


R.L.B.(S+1) 


R.L.B.S 


yes 


No branch succ. 


R.L.B.S 


R.L.(mB+l).l 


R.L.B.S 


- 


Branch succ. 


R.L.B.S 


R.L.(mB+l).l 



"R", "L", "B", and "S" are the "release", "level", "branch", and "sequence" 
components of the SID, respectively; "m" means "maximum". Thus, for exam- 
ple, "R.mL" means "the maximum level number within release R"; 
"R.L.(mB+l).l" means "the first sequence number on the new branch (i.e., max- 
imum branch number plus one) of level L within release R". Note that if the SID 
specified is of the form "R.L", "R.L.B", or "R.L.B.S", each of the specified com- 
ponents must exist. 
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** "hR" is the highest existing release that is lower than the specified, nonexistent, I 

release R. ^ 

* * * This is used to force creation of the first delta in a new release. 

# Successor. 

t The -b keyletter is effective only if the b flag [see admin (1)] is present in the file. 

An entry of - means "irrelevant". 
J This case applies if the d (default SID) flag is not present in the file. If the d flag 

is present in the file, then the SID obtained from the d flag is interpreted as if it 

had been specified on the command line. Thus, one of the other cases in this 

table applies. 

IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved from the SCCS file by 
replacing identification keywords with their value wherever they occur. The following 
keywords may be used in the text stored in an SCCS file: 

Keyword Value 

%M% Module name: either the value of the m flag in the file [see admin{l)], or if 

absent, the name of the SCCS file with the leading s. removed. 
%I% SCCS identification (SID) (%R%.%L%.%B%.%S%) of the retrieved text. 

%R% Release. 

%L% Level. 

%B% Branch. 

%S% Sequence. 

%D% Current date (YY/MM/DD). 
%H% Current date (MM/DD/YY). 

%T% Current time (HH:MM:SS). _ 

%E% Date newest applied delta was created (YY/MM/DD)* I 

%G% Date newest applied delta was created (MM/DD/YY). V 

%U% Time newest applied delta was created (HH:MM:SS). 
%Y% Module type: value of the t flag in the SCCS file [see admind)]. 

%F% SCCS file name. 

%P% Fully qualified SCCS file name. 

%Q% The value of the q flag in the file [see admin(l)]. 
%C% Current line number. This keyword is intended for identifying messages 

output by the program such as "this should not have happened" type 

errors. It is not intended to be used on every line to provide sequence 

numbers. 
%Z% The 4-character string @.(#) recognizable by what(l). 

%W% A shorthand notation for constructing what(l) strings for UNIX system 

program files. %W% = %Z%%M%<horizontal-tab>%I% 
%A% Another shorthand notation for constructing what(l) strings for non-UNIX 

system program files. 

%A% = %Z%%Y% %M% %I%%Z% 

Several auxiliary files may be created by get. These files are known generically as the 
g-file, l-file, p-file, and z-file. The letter before the hyphen is called the tag. An auxili- 
ary file name is formed from the SCCS file name: the last component of all SCCS file 
names must be of the form s.module-name, the auxiliary files are named by replacing 
the leading s with the tag. The g-file is an exception to this scheme: the g-file is 
named by removing the s. prefix. For example, s.xyz.c, the auxiliary file names 
would be xyZoC, l.xyz.c, p.xyzx, and z.xyz.c, respectively. 

The g-file, which contains the generated text, is created in the current directory 

(unless the -p keyletter is used). A g-file is created in all cases, whether or not any t 

lines of text were generated by the get. It is owned by the real user. If the -k V 
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keyletter is used or implied its mode is 644; otherwise its mode is 444. Only the real 
user need have write permission in the current directory. 

The l-file contains a table showing which deltas were applied in generating the 
retrieved text. The l-file is created in the current directory if the -1 keyletter is used; 
its mode is 444 and it is owned by the real user. Only the real user need have write 
permission in the current directory. 

Lines in the l-file have the following format: 

a. A blank character if the delta was applied; 

* otherwise. 

b. A blank character if the delta was applied or was not applied and 
ignored; 

* if the delta was not applied and was not ignored. 

c. A code indicating a "special" reason why the delta was or was not 
applied: "I": Included. 

"X": Excluded. 

"C": Cut off (by a -c keyletter). 

d. Blank. 

e. SCCS identification (SID). 

f . Tab character. 

g. Date and time (in the form YY/MM/DD HH:MM:SS) of creation, 
h. Blank. 

i. Login name of person who created delta. 

The comments and MR data follow on subsequent lines, indented one horizon- 
tal tab character. A blank line terminates each entry. 

The p-file is used to pass information resulting from a get with an -e keyletter along 
to delta. Its contents are also used to prevent a subsequent execution of get with an 
-e keyletter for the same SID until delta is executed or the joint edit flag, j, [see 
adminO.)] is set in the SCCS file. The p-file is created in the directory containing the 
SCCS file and the effective user must have write permission in that directory. Its 
mode is 644 and it is owned by the effective user. The format of the p-file is: the got- 
ten SID, followed by a blank, followed by the SID that the new delta will have when it 
is made, followed by a blank, followed by the login name of the real user, followed 
by a blank, followed by the date-time the get was executed, followed by a blank and 
the -i keyletter argument if it was present, followed by a blank and the -x keyletter 
argument if it was present, followed by a new-line. There can be an arbitrary 
number of lines in the p-file at any time; no two lines can have the same new delta 
SID. 

The z-file serves as a lock-out mechanism against simultaneous updates. Its contents 
are the binary (2 bytes) process ID of the command (i.e., get) that created it. The z-file 
is created in the directory containing the SCCS file for the duration of get. The same 
protection restrictions as those for the p-file apply for the z-file. The z-file is created 
mode 444. 



FILES 



g-file Existed before the execution of delta; removed after completion of 

delta . 
p-file Existed before the execution of delta; may exist after completion of 

delta. 
q-file Created during the execution of delta; removed after completion of 
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x-file Created during the execution of delta; renamed to SCCS file after | 

completion of delta. ^- 

z-file Created during the execution of delta; removed during the execution 

of delta. 
d-file Created during the execution of delta; removed after completion of 

delta . 
/usr/bin/bdiff Program to compute differences between the "gotten" file and the 

g-file. 

SEE ALSO 

admin(l), delta(l), help(l), prs(l), what(l). 

DIAGNOSTICS 

Use help (1 ) f or explanations. 

BUGS 

If the effective user has write permission (either explicitly or implicitly) in the direc- 
tory containing the SCCS files, but the real user does not, then only one file may be 
named when the -e keyletter is used. 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLE 



SEE ALSO 
DIAGNOSTICS 

WARNINGS 



getopt - parse command options 

set — v getopt optstring $* v 

WARNING: Start using the new command getoptsd) in place of getopt (1). getopt (1) 
will not be supported in the next major release. For more information, see the 
WARNINGS section, below. 

getopt is used to break up options in command lines for easy parsing by shell pro- 
cedures and to check for legal options, optstring is a string of recognized option 
letters (see getoptOQ); if a letter is followed by a colon, the option is expected to have 
an argument which may or may not be separated from it by white space. The special 
option — is used to delimit the end of the options. If it is used explicitly, getopt will 
recognize it; otherwise, getopt will generate it; in either case, getopt will place it at the 
end of the options. The positional parameters ($1 $2 ... ) of the shell are reset so that 
each option is preceded by a - and is in its own positional parameter; each option 
argument is also parsed into its own positional parameter. 

The following code fragment shows how one might process the arguments for a com- 
mand that can take the options a or b, as well as the option o, which requires an 
argument: 



set 


-- •- getopt . 


abo: $*^ 


if [ 


$? != ] 




then 


echo $USAGE 
exit 2 




fi 






for 


i in $* 




do 


case $i in 






-a 1 -b) 


FLAG=$i; shift;; 




-o) 


0ARG=$2; shift 2;; 




— ) 


shift; break; ; 




esac 





done 

This code will accept any of the following as equivalent: 

cmd -aoarg file file 

cmd -a -o arg file file 

cmd -oarg -a file file 

cmd -a -oarg — file file 

getopts(l), sh(l), getopt(3C). 

getopt prints an error message on the standard error when it encounters an option 
letter not included in optstring. 

getopt (1) does not support the part of Rule 8 of the command syntax standard (see 
introQ)) that permits groups of option-arguments following an option to be 
separated by white space and quoted. For example, 
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cmd -a -b -o "xxx z yy" file 



is not handled correctly). To correct this deficiency, use the new command getopts (1) 
in place of getoptO). 

getopt(l) will not be supported in the next major release. For this release a conver- 
sion tool has been provided, getoptcvt. For more information about getopts and 
getoptcvt, see the getopts (1) manual page. 

If an option that takes an option-argument is followed by a value that is the same as 
one of the options listed in optstring (referring to the earlier EXAMPLE section, but 
using the following command line: cmd -o -a file), getopt will always treat -a 
as an option-argument to -o; it will never recognize -a as an option. For this case, 
the for loop in the example will shift past the file argument. 



( 



( 
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NAME 
SYNOPSIS 

DESCRIPTION 



EXAMPLE 



GET0PTS(1) 



getopts, getoptcvt - parse command options 

getopts optstring name [arg . . .] 
/usr/lib/getoptcvt [-b] file 

getopts is used by shell procedures to parse positional parameters and to check for 
legal options. It supports all applicable rules of the command syntax standard (see 
Rules 3-10, intro(l)). It should be used in place of the getopt(l) command. (See the 
WARNING, below.) 

optstring must contain the option letters the command using getopts will recognize; if 
a letter is followed by a colon, the option is expected to have an argument, or group 
of arguments, which must be separated from it by white space. 

Each time it is invoked, getopts will place the next option in the shell variable name 
and the index of the next argument to be processed in the shell variable OPTIND. 
Whenever the shell or a shell procedure is invoked, OPTIND is initialized to 1. 

When an option requires an option-argument, getopts places it in the shell variable 
OPTARG. 

If an illegal option is encountered, ? will be placed in name . 

When the end of options is encountered, getopts exits with a non-zero exit status. The 
special option " — " may be used to delimit the end of the options. 

By default, getopts parses the positional parameters. If extra arguments (arg . . .) are 
given on the getopts command line, getopts will parse them instead. 

/usr/lib/getoptcvt reads the shell script in file, converts it to use getopts (1) instead of 
getopt(\), and writes the results on the standard output. 

-b the results of running /usr/lib/getoptcvt will be portable to earlier releases of the 
UNIX system, /usr/lib/getoptcvt modifies the shell script in file so that when the 
resulting shell script is executed, it determines at run time whether to invoke 
getopts(l) or getoptd). 

So all new commands will adhere to the command syntax standard described in 
intro(l), they should use getopts (1) or getopt (3C) to parse positional parameters and 
check for options that are legal for that command (see WARNINGS, below). 

The following fragment of a shell program shows how one might process the argu- 
ments for a command that can take the options a or b, as well as the option o, which 
requires an option-argument: 

while getopts abo: c 



do 



case 
a I 
o) 
\?) 

esac 



$c 
b) 



FLAG=$c; ; 
0ARG=$ OPTARG; 
echo $USAGE 
exit 2 ; / 



done 
shift 



expr $OPTIND - 1' 
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SEE ALSO 
WARNING 



DIAGNOSTICS 



This code will accept any of the following as equivalent: 

cmd -a -b -o "xxx z yy" file 

cmd -a -b -o "xxx z yy" — file 

cmd -ab -o xxx,z,yy file 

cmd -ab -o "xxx z yy" file 

cmd -o xxx,z,yy -b -a file 



intro(l), sh(l), getopts(3C). 

Although the following command syntax rule (see intro(D) relaxations are permitted 
under the current implementation, they should not be used because they may not be 
supported in future releases of the system. As in the EXAMPLE section above, a and 
b are options, and the option o requires an option-argument: 

cmd -aboxxx file (Rule 5 violation: options with 

option-arguments must not be grouped with other options) 

cmd -ab -oxxx file (Rule 6 violation: there must be 
white space after an option that takes an option-argument) 

Changing the value of the shell variable OPTIND or parsing different sets of argu- 
ments may lead to unexpected results. 

getopts prints an error message on the standard error when it encounters an option 
letter not included in optstring. 



( 



c 



c 
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SYNOPSIS 

DESCRIPTION 



GETTY(1M) 



getty - set terminal type, modes, speed, and line discipline 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 
/etc/getty -c file 

getty is a program that is invoked by init (1M). It is the second process in the series, 
(init-getty-login-shell) that ultimately connects a user with the UNIX system. It can 
only be executed by the super-user; that is, a process with the user-ID of root. Ini- 
tially getty prints the login message field for the entry it is using from /etc/getiydefs. 
getty reads the user's login name and invokes the login(l) command with the user's 
name as argument. While reading the name, getty attempts to adapt the system to 
the speed and type of terminal being used. It does this by using the options and 
arguments specified. 

Line is the name of a tty line in /dev to which getty is to attach itself, getty uses this 
string as the name of a file in the /dev directory to open for reading and writing. 
Unless getty is invoked with the -h flag, getty will force a hangup on the line by set- 
ting the speed to zero before setting the speed to the default or specified speed. The 
-t flag plus timeout (in seconds), specifies that getty should exit if the open on the line 
succeeds and no one types anything in the specified number of seconds. 

Speed, the optional second argument, is a label to a speed and tty definition in the file 
/etc/gettydef s. This definition tells getty at what speed to initially run, what the login 
message should look like, what the initial tty settings are, and what speed to try next 
should the user indicate that the speed is inappropriate (by typing a <break> charac- 
ter). The default speed is 300 baud. 

Type, the optional third argument, is a character string describing to getty what type 
of terminal is connected to the line in question, getty recognizes the following types: 

none default 

ds40-l Dataspeed40/ 1 

tektronix,tek Tektronix 

vt61 DEC vt61 

vtlOO DEC vtlOO 

hp45 Hewlett-Packard 45 

clOO Concept 100 

The default terminal is none; i.e., any crt or normal terminal unknown to the system. 
Also, for terminal type to have any meaning, the virtual terminal handlers must be 
compiled into the operating system. They are available, but not compiled in the 
default condition. 

Linedisc, the optional fourth argument, is a character string describing which line dis- 
cipline to use in communicating with the terminal. Again the hooks for line discip- 
lines are available in the operating system but there is only one presently available, 
the default line discipline, LDISCO. 

When given no optional arguments, getty sets the speed of the interface to 300 baud, 
specifies that raw mode is to be used (awaken on every character), that echo is to be 
suppressed, either parity allowed, new-line characters will be converted to carriage 
return-line feed, and tab expansion performed on the standard output. It types the 
login message before reading the user's name a character at a time. If a null character 
(or framing error) is received, it is assumed to be the result of the user pushing the 
"break" key. This will cause getty to attempt the next speed in the series. The series 
that getty tries is determined by what it finds in /etc/gettydefs. 



Stardent 1500/3000 



209 



Essential Utilities 



GE1TY<1M) GEtTY(iM) 

After the user's name has been typed in, it is terminated by a new-line or carriage- I 

return character. The latter results in the system being set to treat carriage returns 
appropriately (see ioctl (2)). 

The user's name is scanned to see if it contains any lower-case alphabetic characters; 
if not, and if the name is non-empty, the system is told to map any future upper-case 
characters into the corresponding lower-case characters. 

Finally, login is exec'd with the user's name as an argument. Additional arguments 
may be typed after the login name. These are passed to login,- which will place them 
in the environment (see logind)). 

A check option is provided. When getty is invoked with the -c option and file, it 
scans the file as if it were scanning /etc/gettydef s and prints out the results to the 
standard output. If there are any unrecognized modes or improperly constructed 
entries, it reports these. If the entries are correct, it prints out the values of the vari- 
ous flags. See ioctl(2) to interpret the values. Note that some values are added to the 
flags automatically. 



FILES 

SEE ALSO 
BUGS 



/etc/gettydefs 
/etc/issue 

ct(lC), gettydefs(4), init(lM), inittab(4), ioctl(2), login(l), tty(7). 

While getty understands simple single character quoting conventions, it is not possi- 
ble to quote certain special control characters used by getty. Thus, you cannot login 
via getty and type a #, @, /, !, _, backspace, A U, A D, or & as part of your login name or 
arguments, getty uses them to determine when the end of the line has been reached, 
which protocol is being used, and what the erase character is. They will always be 
interpreted as having their special meaning. 



( 



c 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 

BUGS 



GREP(1) 



grep - search a file for a pattern 

grep [options] limited regular expression [file ...] 

grep searches files for a pattern and prints all lines that contain that pattern, grep uses 
limited regular expressions (expressions that have string values that use a subset of 
the possible alphanumeric and special characters) like those used with ed (1) to match 
the patterns. It uses a compact non-deterministic algorithm. 

Be careful using the characters $, *, [, A , I, (, ), and \ in the limited regular expression 
because they are also meaningful to the shell. It is safest to enclose the entire limited 
regular expression in single quotes 

If no files are specified, grep assumes standard input. Normally, each line found is 
copied to standard output. The file name is printed before each line found if there is 
more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it was found. This can be 



-c 
-i 
-1 

-n 
-s 

-v 



useful in locating block numbers by context (first block is 0). 

Print only a count of the lines that contain the pattern. 

Ignore upper/lower case distinction during comparisons. 

Print the names of files with matching lines once, separated by new-lines. 

Does not repeat the names of files when the pattern is found more than once. 

Precede each line by its line number in the file (first line is 1). 

Suppress error messages about nonexistent or unreadable files 

Print all lines except those that contain the pattern. 



ed(l), egrep(l), fgrep(l), sed(l), sh(l). 

Exit status is if any matches are found, 1 if none, 2 for syntax errors or inaccessible 
files (even if matches were found). 

Lines are limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is defined 
in /usr/include/stdio.h. 

If there is a line with embedded nulls, grep will only match up to the first null; if it 
matches, it will print the entire line. 
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NAME 



SYNOPSIS 
DESCRIPTION 



hd - hexadecimal and ASCII dump 

hdlfileUl + ] offset [.][b]] 

hd dumps file in both hexadecimal and ASCII format. The file argument specifies 
which file is to be dumped. If no file argument is specified, the standard input is 
used. 

The offset argument specifies the offset in the file where dumping is to commence. 
This argument is normally interpreted as octal bytes. If . is appended, the offset is 
interpreted in decimal. If b is appended, the offset is interpreted in blocks of 512 
bytes. If the file argument is omitted, the offset argument must be preceded by +. 

Dumping continues until end-of-file. 



c 



( 



( 
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NAME 

head - give first few lines 

SYNOPSIS 

head [ -count ] [ file ... ] 

DESCRIPTION 

This filter gives the first count lines of each of the specified files, or of the standard 
input. If count is omitted it defaults to 10. 

SEE ALSO 

tail(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



HEUP-(t) 



help - ask for help regarding SCCS 

help [args] 

help finds information to explain a message from a command or explain the use of a 
command. Zero or more arguments may be supplied. If no arguments are given, 
help prompt for one. 

The arguments may be either message numbers (which normally appear in 
parentheses following messages) or command names, of one of the following types: 

typel Begins with non-numerics, ends in numerics. The non- 

numeric prefix is usually an abbreviation for the program or 
set of routines which produced the message (for example, ge6, 
for message 6 from the get command). 

type 2 Does not contain numerics (as a command, such as get) 

type 3 Is all numeric (for example, 222 ) 

The response of the program will be the explanatory information related to the 
argument, if there is any. When all else fails, try help stuck. 

/usr/lib/help directory containing files of message text. 



C 
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NAME 

SYNOPSIS 

DESCRIPTION 



hostid - set or print identifier of current host system 
hostid [ identifier ] 

The hostid command prints the identifier of the current host in hexadecimal. This 
numeric value is expected to be unique across all hosts and is commonly set to the 
host's Internet address. The super-user can set the hostid by giving a hexadecimal 
argument or the hostname; this is usually done in the startup script /etc/rc.local. 



SEE ALSO 

gethostid(2), sethostid(2) 
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NAME 

hostname - set or print name of current host system 

SYNOPSIS 

hostname [ nameofhost ] 

DESCRIPTION 

The hostname command prints the name of the current host, as given before the 
'login" prompt. The super-user can set the hostname by giving an argument. 

SEE ALSO 

gethostname(2), sethostname(2) 



o 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

id outputs the user and group IDs and the corresponding names of the invoking pro- 
cess. If the effective and real IDs are different, both are printed. 

SEE ALSO 

getuid(2), logname(l). 
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NAME 
SYNOPSIS 



DESCRIPTION 



OPTIONS 



INDENT(1) 



indent - indent and format C program source 

indent [ input-file [ output-file ] ] [ -bad I -nbad ] [ -bap I -nbap ] [ -bbb I -nbbb ] 
[ -be I -nbc ] [ -bl I -br ] [ -en ] [ -cdn ] [ -cdb I -nedb ] [ -ce I -nee ] 
[ -cm ] [ -clin ] [ -dn ] [ -din ] [ -dj I -ndj ] [ -ei I -nei ] [ -f el I -nf el ] [ -in ] 
[ -ip I -nip ] [ -In ] [ -len ] [ -Ip I -nip ] [ -npro ] [ -pes I -npes ] 
[-ps I -nps] [-psl I -npsl] [-sc I -nsc] [-sob I -nsob] [-st] [-troff] 
[-v I -nv] 

indent is a C program formatter. It reformats the C program in the input-file accord- 
ing to the switches. The switches which can be specified are described below. They 
may appear before or after the file names. 

NOTE: If you only specify an input-file, the formatting is done 'in-place', that is, the 
formatted file is written back into input-file and a backup copy of input-file is written 
in the current directory. If input-file is named '/blah/blah/file', the backup file is 
named tile.BAK. 

If output-file is specified, indent checks to make sure it is different from input-file. 

The options listed below control the formatting style imposed by indent. 

-bad,-nbad If -bad is specified, a blank line is forced after every block of 
declarations. Default: -nbad. 

-bap,-nbap If -bap is specified, a blank line is forced after every procedure 
body. Default: -nbap. 

-bbb,~nbbb If -bbb is specified, a blank line is forced before every block com- 
ment. Default: -nbbb. 

-bc,-nbc If -be is specified, then a newline is forced after each comma in a 

declaration, -nbc turns off this option. The default is -nbc. 

-br,-bl Specifying -bl lines up compound statements like this: 

if(...) 

{ 
code 

} 

Specifying -br (the default) makes them look like this: 
if U){ 
code 
} 
-en The column in which comments on code start. The default is 33. 

-cdn The column in which comments on declarations start. The default is 

for these comments to start in the same column as those on code. 

-cdb,-ncdb Enables (disables) the placement of comment delimiters on blank 
lines. With this option enabled, comments look like this: 
/* 
* this is a comment 

*/ 
Rather than like this: 

/* this is a comment */ 
This only affects block comments, not comments to the right of 
code. The default is -cdb. 



( 
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-ce,-nce Enables (disables) forcing 'else's to cuddle up to the immediately 

preceding '}'. The default is -ce. 

-cm Sets the continuation indent to be n. Continuation lines will be 

indented that far from the beginning of the first line of the state- 
ment. Parenthesized expressions have extra indentation added to 
indicate the nesting, unless -lp is in effect, -ci defaults to the same 
value as -i. 

-clin Causes case labels to be indented n tab stops to the right of the con- 

taining switch statement. -cli0.5 causes case labels to be indented 
half a tab stop. The default is -cliO. (This is the only option that 
takes a fractional argument.) 

-dn Controls the placement of comments which are not to the right of 

code. Specifying -dl means that such comments are placed one 
indentation level to the left of code. The default -do lines up these 
comments with the code. See the section on comment indentation 
below. 

-din Specifies the indentation, in character positions, from a declaration 

keyword to the following identifier. The default is -dil6. 

-dj,-ndj -dj left justifies declarations, -ndj indents declarations the same as 

code. The default is -ndj. 

-ei,-nei Enables (disables) special else-if processing. If enabled, ifs follow- 

ing elses will have the same indentation as the preceding if state- 
ment. The default is -ei. 

-fcl,-nfcl Enables (disables) the formatting of comments that start in column 

1. Often, comments whose leading '/' is in column 1 have been 
carefully hand formatted by the programmer. In such cases, -nfcl 
should be used. The default is -f cl. 

-in The number of spaces for one indentation level. The default is 8. 

-ip,-nip Enables (disables) the indentation of parameter declarations from 

the left margin. The default is -ip. 

-In Maximum length of an output line. The default is 78. 

-lp,-nlp Lines up code surrounded by parenthesis in continuation lines. If a 

line has a left paren which is not closed on that line, then continua- 
tion lines will be lined up to start at the character position just after 
the left paren. For example, here is how a piece of continued code 
looks with -nip in effect: 

pi = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 
With -lp in effect (the default) the code looks somewhat clearer: 
pi = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 
Inserting two more newlines we get: 
pi = first_procedure(second_procedure(p2, 

p3), 

third_procedure(p4, 

p5»; 

-npro Causes the profile files, './.indent.pro' and W.indent.pro', to be 

ignored. 
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-pcs,-npcs If true (-pes) all procedure calls will have a space inserted between 

the name and the '('. The default is -npes. 

-ps,-nps If true (-ps) the pointer following operator '->' will be surrounded 

by spaces on either side. The default is -nps. 

-psl,-npsl If true (-psl) the names of procedures being defined are placed in 

column 1 - their types, if any, will be left on the previous lines. The 
default is -psl. 

-sc,-nsc Enables (disables) the placement of asterisks C*'s) at the left edge of 

all comments. The default is -sc. 

-sob,-nsob If -sob is specified, indent will swallow optional blank lines. You 

can use this to get rid of blank lines after declarations. Default: 
-nsob. 

-st Causes indent to take its input from stdin, and put its output to 

stdout. 

-Ttypename Adds typename to the list of type keywords. Names accumulate: -T 
can be specified more than once. You need to specify all the 
typenames that appear in your program that are defined by 
typedefs - nothing will be harmed if you miss a few, but the pro- 
gram won't be formatted as nicely as it should. This sounds like a 
painful thing to have to do, but it's really a symptom of a problem 
in C: typedef causes a syntactic change in the language and indent 
can't find all typedefs. 

-troff Causes indent to format the program for processing by troff . It will 

produce a fancy listing in much the same spirit as vgrind. If the 
output file is not specified, the default is standard output, rather 
than formatting in place. 

-v,-nv -v turns on 'verbose' mode; -nv turns it off. When in verbose 

mode, indent reports when it splits one line of input into two or 
more lines of output, and gives some size statistics at completion. 
The default is -nv. 

FURTHER DESCRIPTION 

You may set up your own 'profile' of defaults to indent by creating a file called 
.indent. pro in either your login directory and /or the current directory and including 
whatever switches you like. Switches in '.indent.pro' in the current directory over- 
ride those in your login directory (with the exception of -T type definitions, which 
just accumulate). If indent is run and a profile file exists, then it is read to set up the 
program's defaults. The switches should be separated by spaces, tabs or newlines. 
Switches on the command line, however, override profile switches. 

Comments 

'Box' comments. Indent assumes that any comment with a dash or star immediately 
after the start of comment (that is, '/*-' or 7**0 is a comment surrounded by a box 
of stars. Each line of such a comment is left unchanged, except that its indentation 
may be adjusted to account for the change in indentation of the first line of the com- 
ment. 

Straight text. All other comments are treated as straight text. Indent fits as many 
words (separated by blanks, tabs, or newlines) on a line as possible. Blank lines 
break paragraphs. 
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Comment indentation 

If a comment is on a line with code it is started in the 'comment column', which is set 
by the -en command line parameter. Otherwise, the comment is started at n indenta- 
tion levels less than where code is currently being placed, where n is specified by the 
-dn command line parameter. If the code on a line extends past the comment 
column, the comment starts further to the right, and the right margin may be 
automatically extended in extreme cases. 

Preprocessor lines 

In general, indent leaves preprocessor lines alone. The only reformatting that it will 
do is to straighten up trailing comments. It leaves embedded comments alone. Con- 
ditional compilation (#ifdef...#endif) is recognized and indent attempts to correctly 
compensate for the syntactic peculiarities introduced. 

C syntax 

Indent understands a substantial amount about the syntax of C, but it has a 'forgiv- 
ing' parser. It attempts to cope with the usual sorts of incomplete and misformed 
syntax. In particular, the use of macros like: 

#define forever for(;;) 
is handled properly. 



FILES 



BUGS 



./ indent.pro profile file 
~/ .indent.pro profile file 

Indent has even more switches than Is. 

A common mistake that often causes grief is typing: 

indent *.c 
to the shell in an attempt to indent all the C programs in a directory. This is probably 
a bug, not a feature. 
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NAME 

infocmp - compare or print out terminfo descriptions 

infocmp [-d] [-c] [-n] [-1] [-L] [-C] [-r] [-u] [-s d I i 1 1 1 c] [-v] [~V] [-1] [-w width] 
[-A directory] [-B directory] [termname ...] 

infocmp can be used to compare a binary terminfo (4) entry with other terminfo entries, 
rewrite a terminfo (4) description to take advantage of the use= terminfo field, or print 
out a terminfo (4) description from the binary file (term(4)) in a variety of formats. In 
all cases, the boolean fields will be printed first, followed by the numeric fields, fol- 
lowed by the string fields. 



SYNOPSIS 



DESCRIPTION 



c 



c 



Default Options 

If no options are specified and zero or one termnames are specified, the -I option will 
be assumed. If more than one termname is specified, the -d option will be assumed. 

Comparison Options [-d] [-c] [-n] 

infocmp compares the terminfo (4) description of the first terminal termname with each 
of the descriptions given by the entries for the other terminal's termnames. If a capa- 
bility is defined for only one of the terminals, the value returned will depend on the 
type of the capability: F for boolean variables, -1 for integer variables, and NULL for 
string variables. 

-d produce a list of each capability that is different. In this manner, if one has 

two entries for the same terminal or similar terminals, using infocmp will 
show what is different between the two entries. This is sometimes neces- 
sary when more than one person produces an entry for the same terminal 
and one wants to see what is different between the two. 

-c produce a list of each capability that is common between the two entries. 

Capabilities that are not set are ignored. This option can be used as a quick 
check to see if the -u option is worth using. 

-n produce a list of each capability that is in neither entry. If no termnames are 

given, the environment variable TERM will be used for both of the term- 
names . This can be used as a quick check to see if anything was left out of 
the description. 

Source Listing Options [-1] [-L] [-C] [-r] 

The -I, -L, and -C options will produce a source listing for each terminal named. 

-I use the terminfo(4) names 

-L use the long C variable name listed in <term.h> 

-C use the termcap names 

-r when using -C, put out all capabilities in termcap form 

If no termnames are given, the environment variable TERM will be used for the termi- 
nal name. 

The source produced by the -C option may be used directly as a termcap entry, but 
not all of the parameterized strings may be changed to the termcap format, infocmp 
will attempt to convert most of the parameterized information, but that which it 
doesn't will be plainly marked in the output and commented out. These should be 
edited by hand. 

All padding information for strings will be collected together and placed at the ^ 

beginning of the string where termcap expects it. Mandatory padding (padding infor- I 

mation with a trailing '/') will become optional. ^~ 
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All termcap variables no longer supported by terminfo{4) , but which are derivable 
from other tertninfo(4) variables, will be output. Not all terminfo{%) capabilities will be 
translated; only those variables which were part of termcap will normally be output. 
Specifying the -r option will take off this restriction, allowing all capabilities to be 
output in termcap form. 

Note that because padding is collected to the beginning of the capability, not all capa- 
bilities are output, mandatory padding is not supported, and termcap strings were 
not as flexible, it is not always possible to convert a terminfo(A) string capability into 
an equivalent termcap format. Not all of these strings will be able to be converted. A 
subsequent conversion of the termcap file back into terminfo(A) format will not neces- 
sarily reproduce the original terrninfo(4) source. 

Some common terminfo parameter sequences, their termcap equivalents, and some ter- 
minal types which commonly have such sequences, are: 



Use= Option [-u] 



Terminfo 

%pl%c 

%pl%d 

%pl%'x'%+%c 

%i 

%pl%?%V%>%t%pl%y%+%; 

%p2 is printed before %pl 



Termcap Representative Terminals 

%. adm 

%d hp, ANSI standard, vtlOO 

%+x concept 

%i ANSI standard, vtlOO 

%>xy concept 

%r hp 



-u 



produce a terminfo (A) source description of the first terminal termname 
which is relative to the sum of the descriptions given by the entries for the 
other terminals termnames. It does this by analyzing the differences 
between the first termname and the other termnames and producing a 
description with use= fields for the other terminals. In this manner, it is 
possible to retrofit generic terminfo entries into a terminal's description. Or, 
if two similar terminals exist, but were coded at different times or by dif- 
ferent people so that each description is a full description, using infocmp will 
show what can be done to change one description to be relative to the other. 

A capability will get printed with an at-sign (@) if it no longer exists in the first term- 
name, but one of the other termname entries contains a value for it. A capability's 
value gets printed if the value in the first termname is not found in any of the other 
termname entries, or if the first of the other termname entries that has this capability 
gives a different value for the capability than that in the first termname. 

The order of the other termname entries is significant. Since the terminfo compiler 
tic(lM) does a left-to-right scan of the capabilities, specifying two use= entries that 
contain differing entries for the same capabilities will produce different results 
depending on the order that the entries are given in. infocmp will flag any such 
inconsistencies between the other termname entries as they are found. 

Alternatively, specifying a capability after a use= entry that contains that capability 
will cause the second specification to be ignored. Using infocmp to recreate a descrip- 
tion can be a useful check to make sure that everything was specified correctly in the 
original source description. 

Another error that does not cause incorrect compiled files, but will slow down the 
compilation time, is specifying extra use= fields that are superfluous, infocmp will 
flag any other termname use= fields that were not needed. 
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Other Options £-s d\i\I\c] [-v] [-V] [-1] [-w width] 

-s sort the fields within each type according to the argument below: 

d leave fields in the order that they are stored in the terminfo database. 

i sort by terminfo name. 

1 sort by the long C variable name. 

c sort by the termcap name. 

If no -s option is given, the fields printed out will be sorted alphabetically 
by the terminfo name within each type, except in the case of the -C or the -L 
options, which cause the sorting to be done by the termcap name or the long 
C variable name, respectively. 

-v print out tracing information on standard error as the program runs. 

-V print out the version of the program in use on standard error and exit. 

-1 cause the fields to printed out one to a line. Otherwise, the fields will be 

printed several to a line to a maximum width of 60 characters. 

-w change the output to width characters. 

Changing Databases [-A directory] [-B directory] 

The location of the compiled terminfo(A) database is taken from the environment vari- 
able TERMINFO. If the variable is not defined, or the terminal is not found in that 
location, the system terminfo(A) database, usually in /usr /lib /terminfo, will be used. 
The options -A and ~B may be used to override this location. The -A option will set 
TERMINFO for the first termname and the -B option will set TERMINFO for the other 
termnames. With this, it is possible to compare descriptions for a terminal with the 
same name located in two different databases. This is useful for comparing descrip- 
tions for the same terminal created by different people. Otherwise the terminals 
would have to be named differently in the terminfo(i) database for a comparison to be 
made. 



FILES 
DIAGNOSTICS 



/usr/lib/terminfo/?/* 



compiled terminal description database 



SEE ALSO 
NOTE 



malloc is out of space! 

There was not enough memory available to process all the terminal 
descriptions requested. Run infocmp several times, each time includ- 
ing a subset of the desired termnames. 

use= order dependency found: 

A value specified in one relative terminal specification was different 
from that in another relative terminal specification. 

'use~term' did not add anything to the description. 

A relative terminal name did not contribute anything to the final 
description. 

must have at least two terminal names for a comparison to be done. 

The -u, -d and -c options require at least two terminal names. 

captoinfo(lM), curses(3X), term(4), terminfo(4), tic(lM). 

The termcap database (from earlier releases of UNIX System V) may not be supplied in 
future releases. 
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NAME 
SYNOPSIS 



DESCRIPTION 
Init 



IN1T(1M) 



init, telinit - process control initialization 

/etc/init [ 0123456SsQq ] 
/etc/telinit [ 0123456sSQqabc] 



init is a general process spawner. Its primary role is to create processes from informa- 
tion stored in the file /etc/inittab (see inittab(4)). This file usually has init spawn 
getty's on each line that a user may log in on. It also controls autonomous processes 
required by any particular system. 

init considers the system to be in a run-level at any given time. A run-level can be 
viewed as a software configuration of the system where each configuration allows 
only a selected group of processes to exist. The processes spawned by init for each of 
these run-levels is defined in the inittab file, init can be in one of eight run-levels, 0-6 
and S or s. The run-level is changed by having a privileged user run /etc/init. This 
user-spawned init sends appropriate signals to the original init spawned by the 
operating system when the system was rebooted, telling it which run-level to change 
to. 

init is invoked inside the UNIX system as the last step in the boot procedure. First init 
looks in /etc/inittab for the initdefault entry (see inittab (A)). If there is one, init uses 
the run-level specified in that entry as the initial run-level to enter. If this entry is not 
in /etc/inittab, init requests that the user enter a run-level from the virtual system con- 
sole, /dev/console. If an S or an s is entered, init goes into the SINGLE USER state. 
This is the only run-level that doesn't require the existence of a properly formatted 
/etc/inittab file. If it doesn't exist, then by default the only legal run-level that init can 
enter is the SINGLE USER state. In the SINGLE USER state the virtual console terminal 
/dev/console is opened for reading and writing and the command /bin/su is invoked 
immediately. To exit from the SINGLE USER state, use either init or telinit, to signal 
init to change the run-level of the system. Note that if the shell is terminated (via an 
end-of-file), init will only re-initialize to the SINGLE USER state. 

If init fails to prompt for a new run-level when attempting to boot the system, it may 
be the result of the device /dev/console being linked to a device other than the physi- 
cal system console (/dev/contty). If this occurs, init can be forced to relink 
/dev/console if you type a delete on the physical system console. 

When init prompts for the new run-level, the operator may enter only one of the 
digits through 6 or the letters S or s. If S or s is entered, init operates as previously 
described in the SINGLE USER state with the additional result that /dev/console is 
linked to the user's terminal line, thus making it the virtual system console. A mes- 
sage is generated on the physical console, /dev/contty, saying where the virtual ter- 
minal has been relocated. 

When init comes up initially and whenever it switches out of SINGLE USER state to 
normal run states, it sets the ioctl(2) states of the virtual console, /dev/console, to 
those modes saved in the file /etc/ioctl.syscon. This file is written by init whenever 
the SINGLE USER state is entered. 

If a through 6 is entered init enters the corresponding run-level. Any other input 
will be rejected and the user will be re-prompted. Note that, on the 3B2 Computer, 
the run-levels 0, 1, 5, and 6 are reserved states for shutting the system down; the run- 
levels 2, 3, and 4 are available as normal operating states. 
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Telinit, which is linked to /etc/init, is used to direct the actions of init. It takes a one- 
character argument and signals init via the kill system call to perform the appropriate 
action. The following arguments serve as directives to init. 

0-6 tells init to place the system in one of the run-levels 0-6. 

a,b,c tells init to process only those /etc/inittab file entries having the a, b 

or c run-level set. These are pseudo-states, which may be defined to 
run certain commands, but which do not cause the current run-level 
to change. 

Q,q tells init to re-examine the /etc/inittab file. 

s,S tells init to enter the single user environment. When this level change 

is effected, the virtual system teletype, /dev/console, is changed to 
the terminal from which the command was executed. 
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INIT(1M) INIT(iM) 

If this is the first time init has entered a run-level other than SINGLE USER, init first 
scans inittah for special entries of the type boot and bootwait. These entries are per- 
formed, providing the run-level entered matches that of the entry before any normal 
processing of inittab takes place. In this way any special initialization of the operat- 
ing system, such as mounting file systems, can take place before users are allowed 
onto the system. The inittab file is scanned to find all entries that are to be processed 
for that run-level. 

Run-level 2 is defined to contain all of the terminal processes and daemons that are 
spawned in the multi-user environment. Hence, it is commonly referred to as the 
MULTI-USER state. Run-level 3 is defined to start up remote file sharing processes and 
daemons as well as mount and advertise remote resources. So, run-level 3 extends 
multi-user mode and is known as the Remote File Sharing state. Run-level 4 is avail- 
able to be defined as an alternative multi-user environment configuration, however, 
it is not necessary for system operation and is usually unused. 

In a MULTI-USER environment, the inittab file is set up so that init will create a pro- 
cess for each terminal on the system that the administrator sets up to respawn. 

For terminal processes, ultimately the shell will terminate because of an end-of-file 
either typed explicitly or generated as the result of hanging up. When init receives a 
signal telling it that a process it spawned has died, it records the fact and the reason it 
died in /etc/utmp and /etc/wtmp if it exists (see who (I)). A history of the processes 
spawned is kept in /etc/wtmp. 

To spawn each process in the inittab file, init reads each entry and for each entry that 
should be respawned, it forks a child process. After it has spawned all of the 
processes specified by the inittab file, init waits for one of its descendant processes to _ 

die, a powerfail signal, or until init is signaled by init or telinit to change the system's | 

run-level. When one of these conditions occurs, init re-examines the inittab file. New V 

entries can be added to the inittab file at any time; however, init still waits for one of 
the above three conditions to occur. To get around this, init Q or init q command 
wakes init to re-examine the inittab file immediately. 

If init receives a powerfail signal (SIGPWR) it scans inittab for special entries of the type 
powerfail and powerwait. These entries are invoked (if the run-levels permit) before 
any further processing takes place. In this way init can perform various cleanup and 
recording functions during the powerdown of the operating system. Note that in the 
SINGLE-USER state only powerfail and powerwait entries are executed. 

When init is requested to change run-levels (via telinit), init sends the warning signal 
(SIGTERM) to all processes that are undefined in the target run-level, init waits 5 
seconds before forcibly terminating these processes via the kill signal (SIGKILL). 
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FILES 



SEE ALSO 
DIAGNOSTICS 



WARNINGS 
BUGS 



INIT(1M) 



/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/console 

/dev/contty 

getty(lM), inittab(4), kill(2), login(l), sh(l), termio(7), utmp(4), who(l). 

If init finds that it is respawning an entry from /etc/inittab more than 10 times in 2 
minutes, it will assume that there is an error in the command string in the entry, and 
generate an error message on the system console. It will then refuse to respawn this 
entry until either 5 minutes has elapsed or it receives a signal from a user-spawned 
init {telinit). This prevents init from eating up system resources when someone 
makes a typographical error in the inittab file or a program is removed that is refer- 
enced in the inittab. 

Telinit can be run only by someone who is super-user or a member of group sys. 

Attempting to relink /dev/console with /dev/contty by typing a delete on the system 
console does not work. 
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INSTALL (1B) 

NAME 

SYNOPSIS 

DESCRIPTION 



Utility 



SEE ALSO 



INSTALL(IB) 



install - install binaries 

install [ -c ] [ -m mode ] [ -o owner ] [ -g group ] [ -s ] binary destination 

Binary is moved (or copied if -c is specified) to destination. If destination already 
exists, it is removed before binary is moved. If the destination is a directory then 
binary is moved into the destination directory with its original file-name. 

The mode for Destination is set to 755; the -m mode option may be used to specify a 
different mode. 

Destination is changed to owner root; the -o owner option may be used to specify a 
different owner. 

Destination is changed to group staff; the -g group option may be used to specify a 
different group. 

If the -s option is specified the binary is stripped after being installed. 

Install refuses to move a file onto itself. 

chgrp(l), chmod(l), cp(l), mv(l), strip(l), chown(l) 
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INSTALL (1M) 

NAME 
SYNOPSIS 

DESCRIPTION 



INSTALL(IM) 



-f dirb 



SEE ALSO 



install - install commands 

/etc/install [-c dira] [-f dirb] R] [-n dire] [-m mode] [-u user] [-g group] [-o] [-s] 
file [dirx . . .] 

The install command is most commonly used in- "makefiles" [See maked)] to install a 
file (updated target file) in a specific place within a file system. Each file is installed 
by copying it into the appropriate directory, thereby retaining the mode and owner 
of the original command. The program prints messages telling the user exactly what 
files it is replacing or creating and where they are going. 

If no options or directories (dirx . . .) are given, install will search a set of default 
directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the 
same name as file. When the first occurrence is found, install issues a message saying 
that it is overwriting that file with file, and proceeds to do so. If the file is not found, 
the program states this and exits without further action. 

If one or more directories (dirx . . .) are specified after file, those directories will be 
searched before the directories specified in the default list. 

The meanings of the options are: 

-c dira Installs a new command (file) in the directory specified by dira, only if it 
is not found. If it is found, install issues a message saying that the file 
already exists, and exits without overwriting it. May be used alone or 
with the -s option. 

Forces file to be installed in given directory, whether or not one already 
exists. If the file being installed does not already exist, the mode and 
owner of the new file will be set to 755 and bin, respectively. If the file 
already exists, the mode and owner will be that of the already existing 
file. May be used alone or with the -o or -s options. 

Ignores default directory list, searching only through the given direc- 
tories (dirx . . .). May be used alone or with any other options except -c 
and -f . 

If file is not found in any of the searched directories, it is put in the 
directory specified in dire. The mode and owner of the new file will be 
set to 755 and bin, respectively. May be used alone or with any other 
options except -c and -f . 

The mode of the new file is set to mode. Superuser only. 

The owner of the new file is set to user. Superuser only. 

The group id of the new file is set to group. Superuser only. 

If file is found, this option saves the "found" file by copying it to 
OLDfile in the directory in which it was found. This option is useful 
when installing a frequently used file such as /bin/sh or jetcjgetty, where 
the existing file cannot be removed. May be used alone or with any 
other options except -c. 

-s Suppresses printing of messages other than error messages. May be 

used alone or with any other options. 

make(l). 



-l 



-n 



dire 



-m 



mode 



-u user 



-g group 



-o 
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NAME 

SYNOPSIS 

DESCRIPTION 



installpkg - install all software distribution tapes 
/etc/installpkg 

installpkg spools forward to the second file on the distribution tape, copies this file 
from tape to /trnp/dojnstall, executes /imp/do Jnstall, and finally rewinds the tape. 

If the environment variable $DEBUG JNSTALLPKG is set to debug, an editing session 
is opened on the specific installation script on the tape being read prior to execution. 



c 



( 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



IPCRM(1) 



ipcrm - remove a message queue, semaphore set or shared memory id 
ipcrm [ options ] 

ipcrm will remove one or more specified messages, semaphore or shared memory 
identifiers. The identifiers are specified by the following options: 

-q msqid removes the message queue identifier msqid from the system and des- 
troys the message queue and data structure associated with it. 

-mshmid removes the shared memory identifier shmid from the system. The 
shared memory segment and data structure associated with it are des- 
troyed after the last detach. 

-s semid removes the semaphore identifier setnid from the system and destroys 

the set of semaphores and data structure associated with it. 

-Q msgkey removes the message queue identifier, created with key msgkey, from 
the system and destroys the message queue and data structure associ- 
ated with it. 

-M shmkey removes the shared memory identifier, created with key shmkey, from 
the system. The shared memory segment and data structure associated 
with it are destroyed after the last detach. 

-S semkey removes the semaphore identifier, created with key semkey, from the 
system and destroys the set of semaphores and data structure associ- 
ated with it. 

The details of the removes are described in msgctl(2), shmctlQ), and semctl(2). The 
identifiers and keys may be found by using ipcs(l). 

ipcs(l). 

msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), shmctl(2), shmget(2), 

shmop(2). 
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NAME 

SYNOPSIS 

DESCRIPTION 



Interprocess Communication Utilities 



IPCS(1) 



ipcs - report inter-process communication facilities status 
ipcs [ options ] 

ipcs prints certain information about active inter-process communication facilities. 
Without options, information is printed in short format for message queues, shared 
memory, and semaphores that are currently active in the system. Otherwise, the 
information that is displayed is controlled by the following options: 

Print information about active message queues. 

Print information about active shared memory segments. 

Print information about active semaphores. 



-q 



-m 



-s 



If any of the options -q, -m, or -s are specified, information about only those indi- 
cated will be printed. If none of these three are specified, information about all three 
will be printed subject to these options: 

~b Print biggest allowable size information. (Maximum number of bytes in mes- 
sages on queue for message queues, size of segments for shared memory, and 
number of semaphores in each set for semaphores.) See below for meaning of 
columns in a listing. 

-c Print creator's login name and group name. See below. 

-o Print information on outstanding usage. (Number of messages on queue and 
total number of bytes in messages on queue for message queues and number of 
processes attached to shared memory segments.) 

-p Print process number information. (Process ID of last process to send a mes- 
sage and process ID of last process to receive a message on message queues and 
process ID of creating process and process ID of last process to attach or detach 
on shared memory segments) See below. 

Print time information. (Time of the last control operation that changed the 
access permissions for all facilities. Time of last msgsnd and last msgrcv on mes- 
sage queues, last shmat and last shmdt on shared memory, last semop(2) on 
semaphores.) See below. 

Use all print options. (This is a shorthand notation for -b, -c, -o, -p, and -t.) 

-C corefile 

Use the file corefile in place of /dev/kmem. 

-N namelist 

The argument will be taken as the name of an alternate namelist (/unix is the 
default). 

The column headings and the meaning of the columns in an ipcs listing are given 
below; the letters in parentheses indicate the options that cause the corresponding 
heading to appear; all means that the heading always appears. Note that these 
options only determine what information is provided for each facility; they do not 



-t 



-a 



c 



c 
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determine which facilities will be listed. 



(all) 



ID 
KEY 



MODE 



OWNER 

GROUP 

CREATOR 

CGROUP 

CBYTES 

QNUM 

QBYTES 

LSPID 

LRPID 

STIME 
RTIME 
CTIME 
NATTCH 

SEGSZ 



(all) 
(all) 



(all) 



Type of the facility: 

q message queue; 
m shared memory segment; 
s semaphore. 

The identifier for the facility entry. 

The key used as an argument to msgget, semget, or shmget to create 
the facility entry. (Note: The key of a shared memory segment is 
changed to IPCJPRIVATE when the segment has been removed 
until all processes attached to the segment detach it.) 
The facility access modes and flags: The mode consists of 11 char- 
acters that are interpreted as follows: 
The first two characters are: 

R if a process is waiting on a msgrcv; 
S if a process is waiting on a msgsnd; 
D if the associated shared memory segment has been 
removed. It will disappear when the last process 
attached to the segment detaches it; 
C if the associated snared memory segment is to be cleared 
when the first attach is executed; 
if the corresponding special flag is not set. 
The next 9 characters are interpreted as three sets of three bits each. 
The first set refers to the owner's permissions; the next to permis- 
sions of others in the user-group of the facility entry; and the last to 
all others. Within each set, the first character indicates permission 
to read, the second character indicates permission to write or alter 
the facility entry, and the last character is currently unused. 
The permissions are indicated as follows: 
r if read permission is granted; 
w if write permission is granted; 
a if alter permission is granted; 

if the indicated permission is not granted, 
(all) The login name of the owner of the facility entry, 
(all) The group name of the group of the owner of the facility entry. 
(a,c) The login name of the creator of the facility entry. 
(a,c) The group name of the group of the creator of the facility entry. 
(a,o) The number of bytes in messages currently outstanding on the 

associated message queue. 
(a,o) The number of messages currently outstanding on the associated 

message queue. 
(a,b) The maximum number of bytes allowed in messages outstanding 

on the associated message queue. 
(a,p) The process ID of the last process to send a message to the associ- 
ated queue. 
(a,p) The process ID of the last process to receive a message from the 

associated queue. 
(a,t) The time the last message was sent to the associated queue. 
(a,t) The time the last message was received from the associated queue. 
(a,t) The time when the associated entry was created or changed. 
(a,o) The number of processes attached to the associated shared 

memory segment. 
(a,b) The size of the associated shared memory segment. 
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FILES 



SEE ALSO 
BUGS 



CPID (a,p) The process ID of the creator of the shared memory entry. 

LPID (a,p) The process ID of the last process to attach or detach the shared 

memory segment. 

ATIME (a,t) The time the last attach was completed to the associated shared 
memory segment. 

DTIME (a,t) The time the last detach was completed on the associated shared 
memory segment. 

NSEMS (a,b) The number of semaphores in the set associated with the sema- 
phore entry. 

OTIME (a,t) The time the last semaphore operation was completed on the set 
associated with the semaphore entry. 

/unix system namelist 

/dev/kmem memory 

/etc/passwd user names 

/etc/group group names 

msgop(2), semop(2), shmop(2). 

Things can change while ipcs is running; the picture it gives is only a close approxi- 
mation to reality. 
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J0IN(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLE 



SEE ALSO 
BUGS 



J0IN(1) 



join - relational database operator 

join [ options ] filel file2 

join forms, on the standard output, a join of the two relations specified by the lines of 
filel and filel. If filel is -, the standard input is used. 

Filel and filel must be sorted in increasing ASCII collating sequence on the fields on 
which they are to be joined, normally the first in each line [see sort(l)]. 

There is one line in the output for each pair of lines in filel and file2 that have identi- 
cal join fields. The output line normally consists of the common field, then the rest of 
the line from filel , then the rest of the line from filel . 

The default input field separators are blank, tab, or new-line. In this case, multiple 
separators count as one field separator, and leading separators are ignored. The 
default output field separator is a blank. 

Some of the below options use the argument n. This argument should be a 1 or a 2 
referring to either filel or filel, respectively. The following options are recognized: 

-an In addition to the normal output, produce a line for each unpairable line in file 
n, where n is 1 or 2. 

-e s Replace empty output fields by string s . 

-jn ra Join on the rath field of file n. If n is missing, use the rath field in each file. 
Fields are numbered starting with 1. 

-o list Each output line comprises the fields specified in list, each element of which 
has the form rc.ra, where n is a file number and ra is a field number. The com- 
mon field is not printed unless specifically requested. 

-tc Use character c as a separator (tab character). Every appearance of c in a line 
is significant. The character c is used as the field separator for both input and 
output. 

The following command line will join the password file and the group file, matching 
on the numeric group ID, and outputting the login name, the group name and the 
login directory. It is assumed that the files have been sorted in ASCII collating 
sequence on the group ID fields. 

join -jl 4 -j2 3 -o 1.1 2.1 1.6 -t: /etc/passwd /etc/group 

awk(l), comm(l), sort(l), uniq(l). 

With default field separation, the collating sequence is that of sort -b; with -t, the 
sequence is that of a plain sort. 

The conventions of join, sort, comm, uniq and awk{\) are wildly incongruous. 

Filenames that are numeric may cause conflict when the -o option is used right 
before listing filenames. 
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NAME 



SYNOPSIS 
DESCRIPTION 



kill - terminate a process 
kill [ -signo ] PID ... 



c 



kill sends signal 15 (terminate) to the specified processes. This will normally kill 
processes that do not catch or ignore the signal. The process number of each asyn- 
chronous process started with & is reported by the shell (unless more than one pro- 
cess is started in a pipeline, in which case the number of the last process in the pipe- 
line is reported). Process numbers can also be found by using ps (1). 

The details of the kill are described in kill(2). For example, if process number is 
specified, all processes in the process group are signaled. 

The killed process must belong to the current user unless he is the super-user. 

If a signal number preceded by - is given as first argument, that signal is sent instead 
of terminate (see signal(2)). In particular "kill -9 . . ." is a sure kill. 

SEE ALSO 

ps(l), sh(l), kill(2), signal(2). 



( 



( 
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KILLALL(IM) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
WARNINGS 



killall - kill all active processes 

/etc/killall [ signal ] 

killall is used by /etc/shutdown to kill all active processes not directly related to the 
shutdown procedure. 

killall terminates all processes with open files so that the mounted file systems will be 
unbusied and can be unmounted. 

killall sends signal (see kill{l)) to all processes not belonging to the above group of 
exclusions. If no signal is specified, a default of 9 is used. 

/etc/ shutdown 

fuser(lM), kill(l), ps(l), shutdown(lM), signal(2). 

The killall command can only be run by the super-user. 
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LABELIT(IM) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



LABELIT(IM) 



labelit - provide labels for file systems 

/etc/labelit special [ fsname volume [ -n ] ] 

labelit can be used to provide labels for unmounted disk file systems or file systems 
being copied to tape. The -n option provides for initial labeling only (this destroys 
previous contents). 

With the optional arguments omitted, labelit prints current label values. 

The special name should be the physical disk section (e.g., /dev/dsk/c0d0s6), or the 
cartridge tape (e.g., /dev/SA/ctapel). The device may not be on a remote machine. 

The fsname argument represents the mounted name (e.g., root, ul, etc.) of the file 
system. 

Volume may be used to equate an internal name to a volume name applied externally 
to the disk pack, diskette or tape. 

For file systems on disk, fsname and volume are recorded in the superblock. 
fs(4),sh(l). 
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LAST(1) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
AUTHOR 



last - indicate last logins of users and teletypes 

last [ -N ][ name ... ] [tty ... ] 

last will look back in the wtmp file which records all logins and logouts for informa- 
tion about a user, a teletype or any group of users and teletypes. Arguments specify 
names of users or teletypes of interest. Names of teletypes may be given fully or 
abbreviated. For example 'last 0' is the same as 'last ttyO'. If multiple arguments are 
given, the information which applies to any of the arguments is printed. For exam- 
ple 'last root console' would list all of "root's" sessions as well as all sessions on the 
console terminal, last will print the sessions of the specified users and teletypes, most 
recent first, indicating the times at which the session began, the duration of the ses- 
sion, and the teletype which the session took place on. If the session is still continu- 
ing or was cut short by a reboot, last so indicates. 

The pseudo-user reboot logs in at reboots of the system, thus 

last reboot 

will give an indication of mean time between reboot. 

last with no arguments prints a record of all logins and logouts, in reverse order. The 
-N option limits the report to N lines. 

If last is interrupted, it indicates how far the search has progressed in wtmp. If inter- 
rupted with a quit signal (generated by a controlA) last indicates how far the search 
has progressed so far, and the search continues. 



/etc/wtmp 



login data base 



wtmp(5), ac(8), lastcomm(l) 



Howard Katseff 
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LASTCOWI(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 



LASTCOMM (1) 



lastcomm - show last commands executed in reverse order 

lastcomm [ command name ] ... [user name] ... [terminal name] ... 

lastcomm gives information on previously executed commands. With no arguments, 
lastcomm prints information about all the commands recorded during the current 
accounting file's lifetime. If called with arguments, only accounting entries with a 
matching command name, user name, or terminal name are printed. So, for example, 

lastcomm a.out root ttydO 
would produce a listing of all the executions of commands named a.out by user root 
on the terminal ttydO . 

For each process entry, the following are printed. 
The name of the user who ran the process. 
Hags, as accumulated by the accounting facilities in the system. 
The command name under which the process was called. 
The amount of cpu time used by the process (in seconds). 
The time the process exited. 

The flags are encoded as follows: "S" indicates the command was executed by the 
super-user, "F" indicates the command ran after a fork, but without a following exec, 
"D" indicates the command terminated with the generation of a core file, and "X" 
indicates the command was terminated with a signal. 



/usr/adm/pacct 
last(l), sigvec(2), acct(8) 
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LD(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



LD(1) 



Id - link editor for common object files 

Id [options] filename 

The Id command combines several object files into one, performs relocation, resolves 
external symbols, and supports symbol table information for debugging. In the sim- 
plest case, the names of several object programs are given, and Id combines the 
objects, producing an object module that can be executed. The output of Id is left in 
a.out. By default this file is executable if no errors occurred during the load. If any 
input file, filename, is not an object file, Id assumes it is an archive library. 

If any argument is a library, it is searched exactly once at the point it is encountered 
in the argument list. Only those routines defining an unresolved external reference 
are loaded. The library (archive) symbol table [see ar(4)] is searched sequentially 
with as many passes as are necessary to resolve external references which can be 
satisfied by library members. Thus, the ordering of library members is functionally 
unimportant, unless there exist multiple library members defining the same external 
symbol. 

The following options are recognized by Id : 

-B hhhhhhh 

Generate an a.out file with the bss address at hhhhhhh. 

-D hhhhhhh 

Generate an a.out file with the data address at hhhhhhh. 

-esym 

Set the default entry point address for the output file to be that of sym. 

-L Do not search for -1 libraries in /lib or /usr/lib. 

-Ldir 

Search for -1 libraries in dir. 

-m Generate a simple load map on standarad output. 

-n Generate NMAGIC file type. 

-o filename 

Place the output into filename. 

-opct 

Insert code into the program that produces a count of all the FPU ops executed 
by the program, dynamically. 

-p Generate code to profile the source file during execution. 

-r Produce a relocatable output file. 

-s Strip line numbers and symbol table information from the output object file. 

-T hhhhhhh 

Generate an a.out file with the text address at hhhhhhh. 

-t Turn off warnings about multiply defined symbols that are not the same size. 

-uname 

Enter name as an undefined symbol in the symbol table. 

-V Print version information. 
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-yname 

Trace name and print out all uses and definitions. 

LIBDIR/libjca libraries 

LLIBDIR/libx.a libraries 

a.out output file 

LIBDIR usually /lib 

LLIBDIR usually /usr/lib 

as(l), cc(l), fc(l), exit(2), end(3C), a.out(4), ar(4). 
Programmer's Guide. 



( 
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LEAVE(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



LEAVE (1) 



leave - remind you when you have to leave 

leave [ [+]hhmm ] 

leave waits until the specified time, then reminds you that you have to leave. You are 
reminded 5 minutes and 1 minute before the actual time, at the time, and every 
minute thereafter. When you log off, leave exits just before it would have printed the 
next message. 

The time of day is in the form hhmm where hh is a time in hours (on a 12 or 24 hour 
clock). All times are converted to a 12 hour clock, and assumed to be in the next 12 
hours. 

If the time is preceeded by '+', the alarm will go off in hours and minutes from the 
current time. 

If no argument is given, leave prompts with "When do you have to leave?". A reply of 
newline causes leave to exit, otherwise the reply is assumed to be a time. This form is 
suitable for inclusion in a .login or .-profile. 

leave ignores interrupts, quits, and terminates. To get rid of it you should either log 
off or use "kill -9" giving its process id. 

calendar(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 
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EXAMPLE 



LEX(1) 



lex - generate programs for simple lexical tasks 
lex [ -rctvn ] [ file ] ... 

The lex command generates programs to be used in simple lexical analysis of text. 

The input files (standard input default) contain strings and expressions to be 
searched for, and C text to be executed when strings are found. 

A file lex.yy.c is generated which, when loaded with the library, copies the input to 
the output except when a string specified in the file is found; then the corresponding 
program text is executed. The actual string matched is left in yytext, an external char- 
acter array. Matching is done in order of the strings in the file. The strings may con- 
tain square brackets to indicate character classes, as in [abx-z] to indicate a, b, x, y, 
and z; and the operators *, +, and ? mean respectively any non-negative number of, 
any positive number of, and either zero or one occurrence of, the previous character 
or character class. The character . is the class of all ASCII characters except new-line. 
Parentheses for grouping and vertical bar for alternation are also supported. The 
notation r{d,e] in a rule indicates between d and e instances of regular expression r. 
It has higher precedence than I , but lower than *, ?, +, and concatenation. Thus 
[a-zA-Z]+ matches a string of letters. The character A at the beginning of an expres- 
sion permits a successful match only immediately after a new-line, and the character 
$ at the end of an expression requires a trailing new-line. The character / in an 
expression indicates trailing context; only the part of the expression up to the slash is 
returned in yytext, but the remainder of the expression must follow in the input 
stream. An operator character may be used as an ordinary symbol if it is within " 
symbols or preceded by \. 

Three subroutines defined as macros are expected: inputO to read a character; 
unput(c) to replace a character read; and output(c) to place an output character. 
They are defined in terms of the standard streams, but you can override them. The 
program generated is named yylexO, and the library contains a mainO which calls it. 
The action REJECT on the right side of the rule causes this match to be rejected and 
the next suitable match executed; the function yymoreO accumulates additional char- 
acters into the same yytext; and the function yyless(p) pushes back the portion of the 
string matched beginning at p, which should be between yytext and yytext+yyleng. 
The macros input and output use files yyin and yyout to read from and write to, 
defaulted to stdin and stdout, respectively. 

Any line beginning with a blank is assumed to contain only C text and is copied; if it 
precedes %% it is copied into the external definition area of the lex.yy.c file. All rules 
should follow a %%, as in YACC. Lines preceding %% which begin with a non-blank 
character define the string on the left to be the remainder of the line; it can be called 
out later by surrounding it with 0. Note that curly brackets do not imply 
parentheses; only string substitution is done. 



D 

%% 

if 

[a-z]+ 

0{D}+ 

{D}+ 



[0-9] 

printfC'IF statementW); 
printf("tag, value %s\n",yytext); 
printf("octal number %s\n",yytext); 
printf("decimal number %s\n M ,yytext); 
printfC'unary op\n"); 
printf("binary op\n"); 



c 
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SEE ALSO 
BUGS 



"/*" skipcommntsO; 

%% 

skipcommntsO 



for (;;) 
{ 



while (inputO != '*') 

if (input() !='/') 

unput(yytext[yyleng-l]); 
else 

return; 



The external names generated by lex all begin with the prefix yy or YY. 

The flags must appear before any files. The flag -r indicates RATFOR actions, -c indi- 
cates C actions and is the default, -t causes the lex.yy.c program to be written instead 
to standard output, -v provides a one-line summary of statistics, -n will not print out 
the -v summary. Multiple files are treated as a single file. If no files are specified, 
standard input is used. 

Certain table sizes for the resulting finite state machine can be set in the definitions 
section: 

%p n number of positions is n (default 2500) 

%n n number of states is n (500) 

%e n number of parse tree nodes is n (1000) 

%a n number of transitions is n (2000) 

%k n number of packed character classes is n (1000) 

%o n size of output array is n (3000) 

The use of one or more of the above automatically implies the -v option, unless the 
-n option is used. 

yacc(l). 

The -r option is not yet fully operational. 
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LINE(1) LINE(1) 

NAME 

line - read one line 

SYNOPSIS 

line 

DESCRIPTION 

line copies one line (up to a new-line) from the standard input and writes it on the 
standard output. It returns an exit code of 1 on EOF and always prints at least a 
new-line. It is often used within shell files to read from the user's terminal. 

SEE ALSO 

sh(l), read(2). 



( 
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L1NK(1M) 

NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
WARNINGS 



LINK(1M) 



link, unlink - link and unlink files and directories 

/etc/link filel file2 
/etc/unlink file 

The link command is used to create a file name that points to another file. Linked 
files and directories can be removed by the unlink command; however, it is strongly- 
recommended that the rra(l) and rmdir{\) commands be used instead of the unlink 
command. 

The only difference between ln{\) and link/ unlink is that the latter do exactly what 
they are told to do, abandoning all error checking. This is because they directly 
invoke the link(2) and unlink(2) system calls. 

link(2),unlink(2),rm(l). 

These commands can only be run by the super-user. 
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NAME 

SYNOPSIS 

DESCRIPTION 
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SEE ALSO 



LOCALIZE (1) 

localize - make names local to an object file 

localize filename [ globalnames... ] 

The localize command makes all but a specified list of names local to the object file. 
filename is both read and written, globalnames are external entry points in the .o file 
that are retained. This command is particularly useful when an object file is created 
with the Id -r. 



ld(l) 
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LOGGER (1) 



NAME 

SYNOPSIS 

ARGUMENTS 



DESCRIPTION 



EXAMPLES 



SEE ALSO 



logger - make entries in the system log 

logger [ -t tag ] [ -p pri ] [ -i ] [ -f file ] [ message ... ] 

-t tag Mark every line in the log with the specified tag. 

-p pri Enter the message with the specified priority. The priority may be 

specified numerically or as a "facility. level" pair. For example, "-p 
locaB.info" logs the message(s) as informational level in the local3 facil- 
ity. The default is "user.notice." 

-i Log the process id of the logger process with each line. 

-f file Log the specified file. 

message The message to log; if not specified, the -f file or standard input is 
logged. 

Logger provides a program interface to the syslog(3) system log module. 

A message can be given on the command line, which is logged immediately, or a file 
is read and each line is logged. 

logger System rebooted 

logger -p localO.notice -t HOSTIDM -f /dev/idmc 

syslog(3), syslogd(8) 
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LQGHi(i) 

NAME 

SYNOPSIS 

DESCRIPTION 



LOGIN (1) 



login - sign on 

login [ name [ env-var . . . ] ] 

The login command is used at the beginning of each terminal session and allows you 
to identify yourself to the system. It may be invoked as a command or by the system 
when a connection is first established. Also, it is invoked by the system when a pre- 
vious user has terminated the initial shell by typing a cntrl-d to indicate an "end-of- 
file." (See How to Get Started at the beginning of this volume for instructions on how 
to dial up initially.) 

If login is invoked as a command it must replace the initial command interpreter. 
This is accomplished by typing: exec login from the initial shell. 

login asks for your user name (if not supplied as an argument), and, if appropriate, 
your password. Echoing is turned off (where possible) during the typing of your 
password, so it will not appear on the written record of the session. 

At some installations, an option may be invoked that will require you to enter a 
second "dialup" password. This will occur only for dial-up connections, and will be 
prompted by the message "dialup password:". Both passwords are required for a 
successful login. 

If you do not complete the login successfully within a certain period of time (e.g., one 
minute), you are likely to be silently disconnected. 

After a successful login, accounting files are updated, the procedure /etc/profile is 
performed, the message-of-the-day, if any, is printed, the user-ID, the group-ID, the 
working directory, and the command interpreter (usually sh(l)) is initialized, and the 
file .profile in the working directory is executed, if it exists. These specifications are 
found in the /etc/passwd file entry for the user. The name of the command inter- 
preter is - followed by the last component of the interpreter's path name (i.e., -sh). If 
this field in the password file is empty, then the default command interpreter, /bin/sh 
is used. If this field is "*", then the named directory becomes the root directory, the 
starting point for path searches for path names beginning with a /. At that point login 
is re-executed at the new level which must have its own root structure, including 
/etc/login and /etc/passwd. 

The basic environment is initialized to: 

HOME=your-login-directory 
PATH=:/bin:/usr/bin 
SHELL=last-field-of-passwd-entry 
MAIL=/usr/ 'mail /your-login-name 
TZ=timezone-specification 

The environment may be expanded or modified by supplying additional arguments 
to login, either at execution time or when login requests your login name. The argu- 
ments may take either the form xxx or xxx=yyy. Arguments without an equal sign are 
placed in the environment as Ln=xxx where n is a number starting at and is incre- 
mented each time a new variable name is required. Variables containing an = are 
placed into the environment without modification. If they already appear in the 
environment, then they replace the older value. There are two exceptions. The vari- 
ables PATH and SHELL cannot be changed. This prevents people, logging into res- 
tricted shell environments, from spawning secondary shells which are not restricted. 
Both login and getty understand simple single-character quoting conventions. Typing 
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LOGIN (1) 



FILES 



SEE ALSO 
DIAGNOSTICS 



NOTE 



a backslash in front of a character quotes it and allows the inclusion of such things as 
spaces and tabs. 



/etc/utmp 

/etc/wtmp 

/usr/ mail /your-name 

/etc/motd 

/etc/passwd 

/etc/profile 

.profile 

/usr/adm/lastlog 



accounting 

accounting 

mailbox for user your-name 

message-of-the-day 

password file 

system profile 

user's login profile 

records last login time 



mail(l), newgrp(l), sh(l), su(lM), passwd(4), profile(4), environ(5). 

login incorrect if the user name or the password cannot be matched. 
No shell, cannot open password file, or no directory: consult a UNIX system program- 
ming counselor. 

No utmp entry. You must exec "login" from the lowest level "sh" if you attempted to exe- 
cute login as a command without using the shell's exec internal command or from 
other than the initial shell. 

After a successful login, accounting files are updated and the user is informed of the 
existence of mail. The message of the day is printed, as is the time of the last login. 
Both are suppressed if the user's home directory contains a ".hushlogin" file; this is 
mostly used to make life easier for non-human users, such as uucp (1C). 
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LOQNAM£(1) 

NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 



LOGNAME (T) 



logname - get login name 

logname 

logname returns the contents of the environment variable $LOGNAME, which is set 
when a user logs into the system. 

/etc/profile 

env(l), login(l). logname(3X), environ(5). 
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LOOK(1) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 



look - find lines in a sorted list 

look [ -df ] string [ file ] 

Look consults a sorted file and prints all lines that begin with string. It uses binary 
search. 

The options d and f affect comparisons as in sort(l): 

d 'Dictionary' order: only letters, digits, tabs and blanks participate in comparis- 
ons. 

f Fold. Upper case letters compare equal to lower case. 

If no file is specified, /usr/dict/words is assumed with collating sequence -df. 

/usr/ diet/ words 

sort(l), grep(l) 
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LP(1) 

NAME 
SYNOPSIS 

DESCRIPTION 



LP(1) 



lp, cancel - send/cancel requests to an LP line printer 

lp [~c] [-ddest] [-m] [-n number] [-o option] [-s] [-t title] [-w] files 
cancel [ ids ] [ printers ] 

lp arranges for the named files and associated information (collectively called a 
request) to be printed by a line printer. If no file names are mentioned, the standard 
input is assumed. The file name - stands for the standard input and may be supplied 
on the command line in conjunction with named files . The order in which files appear 
is the same order in which they will be printed. 

lp associates a unique id with each request and prints it on the standard output. This 
id can be used later to cancel (see cancel) or find the status (see lpstat(l)) of the 
request. 

The following options to lp may appear in any order and may be intermixed with file 
names: 

-c Make copies of the files to be printed immediately when lp is invoked. 

Normally, files will not be copied, but will be linked whenever possible. 
If the -c option is not given, then the user should be careful not to 
remove any of the files before the request has been printed in its entirety. 
It should also be noted that in the absence of the -c option, any changes 
made to the named files after the request is made but before it is printed 
will be reflected in the printed output. 

-ddest Choose dest as the printer or class of printers that is to do the printing. If 

dest is a printer, then the request will be printed only on that specific 
printer. If dest is a class of printers, then the request will be printed on 
the first available printer that is a member of the class. Under certain 
conditions (printer unavailability, file space limitation, etc.), requests for 
specific destinations may not be accepted (see accept(lM) and IpstatiX)). 
By default, dest is taken from the environment variable LPDEST (if it is 
set). Otherwise, a default destination (if one exists) for the computer sys- 
tem is used. Destination names vary between systems (see IpstatiX)). 

-m Send mail (see mail(D) after the files have been printed. By default, no 

mail is sent upon normal completion of the print request. 

-nnumher Print number copies (default of 1) of the output. 

-ooption Specify printer-dependent or class-dependent options. Several such 
options may be collected by specifying the -o keyletter more than once. 
For more information about what is valid for options, see Models in 

IpadminiXM). 

-s Suppress messages from lp{\) such as "request id is ...". 

-ttitle Print title on the banner page of the output. 

-w Write a message on the user's terminal after the files have been printed. If 

the user is not logged in, then mail will be sent instead. 

Cancel cancels line printer requests that were made by the lp{\) command. The com- 
mand line arguments may be either request ids (as returned by lp(D) or printer names 
(for a complete list, use lpstat(D). Specifying a request id cancels the associated 
request even if it is currently printing. Specifying a printer cancels the request which 
is currently printing on that printer. In either case, the cancellation of a request that 
is currently printing frees the printer to print its next available request. 
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FILES 

/usr/spool/lp/* 

SEE ALSO 

accept(lM), enable(l), lpadmin(lM), lpsched(lM), lpstat(l), mail(l). 
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NAME 
SYNOPSIS 

DESCRIPTION 



Restrictions. 



LPADMIN (1M) 



lpadmin - configure the LP spooling system 

/usr/lib/lp admin -p printer [ options ] 
/usr/lib/lp admin -x dest 
/usr/lib/lp admin -d[dest] 

lpadmin configures line printer (LP) spooling systems to describe printers, classes and 
devices. It is used to add and remove destinations, change membership in classes, 
change devices for printers, change printer interface programs and to change the sys- 
tem default destination, lpadmin may not be used when the LP scheduler, 
lpsched(lM), is running, except where noted below. 

Exactly one of the -p, -d or -x options must be present for every legal invocation of 

lpadmin. 

-^printer names a printer to which all of the options below refer. If printer does not 
exist then it will be created. 

-xdest removes destination dest from the LP system. If dest is a printer and is 

the only member of a class, then the class will be deleted, too. No other 
options are allowed with -x. 

-d[dest] makes dest, an existing destination, the new system default destination. 
If dest is not supplied, then there is no system default destination. This 
option may be used when Ipsched (1M) is running. No other options are 
allowed with -d. 

The following options are only useful with -p and may appear in any order. For ease 
of discussion, the printer will be referred to as P below. 

-cclass inserts printer P into the specified class. Class will be created if it does 

not already exist. 

-eprinter copies an existing printer's interface program to be the new interface 
program for P. 

-h indicates that the device associated with P is hardwired. This option is 

assumed when adding a new printer unless the -1 option is supplied. 

-{interface establishes a new interface program for P. Interface is the path name of 
the new program. 

-1 indicates that the device associated with P is a login terminal. The LP 

scheduler, Ipsched, disables all login terminals automatically each time it 
is started. Before re-enabling P, its current device should be established 
using lpadmin. 

-mmodel selects a model interface program for P. Model is one of the model inter- 
face names supplied with the LP Spooling Utilities (see Models below). 

-rclass removes printer P from the specified class. If P is the last member of the 

class , then the class will be removed. 

-vdevice associates a new device with printer P. Device is the pathname of a file 
that is writable by Ip. Note that the same device can be associated with 
more than one printer. If only the -p and -v options are supplied, then 
lpadmin may be used while the scheduler is running. 

When creating a new printer, the -v option and one of the -e, -i or -m options must 
be supplied. Only one of the -e, -i or -m options may be supplied. The -h and -1 
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keyletters are mutually exclusive. Printer and class names may be no longer than 14 
characters and must consist entirely of the characters A-Z, a-z, 0-9 and _ (under- 
score). 

Model printer interface programs are supplied with the LP Spooling Utilities. They 
are shell procedures which interface between Ipsched and devices. All models reside 
in the directory /usr/spool/lp/model and may be used as is with Ipadmin -m. Copies 
of model interface programs may also be modified and then associated with printers 
using Ipadmin -i. The following describes two models which may be given on the Ip 
command line using the -o keyletter: 

PS 

tek4693 



A 300-dpi PostScript® laser printer, such as the Apple LaserWriter. 
The Tektronix 4693D 300-dpi color thermal transfer printer. 



1. Use the following command to connect a PostScript printer named PS1: 

/usr/lib/lpadmin -pPS -v/dev/ttyO -mPS.interface 

2. Use the following command to install a Tektronix 4693D color printer: 

/usr/lib/lpadmin -pTEK -v/dev/tek -mtek4693 

/usr/spool/lp/* 

accept(lM), enabled), lpd), lpsched(lM), lpstat(l). 
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lpsched, lpshut, lpmove - start/ stop the LP scheduler and move requests 

/usr/lib/lpsched 
/usr/lib/lpshut 

/usr/lib/lpmove requests dest 
/usr/lib/lpmove destl dest2 

lpsched schedules requests taken by lp{\) for printing on line printers (LP's). 

Lpshut shuts down the line printer scheduler. All printers that are printing at the 
time lpshut is invoked will stop printing. Requests that were printing at the time a 
printer was shut down will be reprinted in their entirety after lpsched is started again. 

Lpmove moves requests that were queued by lp{\) between LP destinations. This 
command may be used only when lpsched is not running. 

The first form of the command moves the named requests to the LP destination, dest. 
Requests are request ids as returned by lp{\). The second form moves all requests for 
destination destl to destination destl. As a side effect, lp (1) will reject requests for 
destl . 

Note that lpmove never checks the acceptance status (see accept(lM)) for the new des- 
tination when moving requests. 

/usr/spool/lp/* 

accept(lM), enabled ), lp(l), Ipadmin(lM), Ipstat(l). 
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lpstat - print LP status information 
lpstat [ options ] 

lpstat prints information about the current status of the LP spooling system. 

If no options are given, then lpstat prints the status of all requests made to lp{l) by the 
user. Any arguments that are not options are assumed to be request ids (as returned 
by Ip). lpstat prints the status of such requests. Options may appear in any order and 
may be repeated and intermixed with other arguments. Some of the keyletters below 
may be followed by an optional list that can be in one of two forms: a list of items 
separated from one another by a comma, or a list of items enclosed in double quotes 
and separated from one another by a comma and/or one or more spaces. For exam- 
ple: 

-u ,f userl, user2, user3" 

The omission of a list following such keyletters causes all information relevant to the 
keyletter to be printed, for example: 

lpstat -o 

prints the status of all output requests. 

-a[ list ] Print acceptance status (with respect to Ip) of destinations for requests. List 
is a list of intermixed printer names and class names. 

-c[ list ] Print class names and their members. List is a list of class names. 

-d Print the system default destination for Ip. 

-o[list] Print the status of output requests. List is a list of intermixed printer 
names, class names, and request ids . 

-p[ list] Print the status of printers. List is a list of printer names. 

-r Print the status of the LP request scheduler 

-s Print a status summary, including the system default destination, a list of 

class names and their members, and a list of printers and their associated 
devices. 

-t Print all status information. 

-u[ list] Print status of output requests for users. List is a list of login names. 

-v[list] Print the names of printers and the path names of the devices associated 
with them. List is a list of printer names. 



/usr/spool/lp/* 
enabled), lp(l). 
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Is - list contents of directory 

Is [ -RadCxmlnogrtucpFbqisf ] [names] 

For each directory argument, Is lists the contents of the directory; for each file argu- 
ment, b repeats its name and any other information requested. The output is sorted 
alphabetically by default. When no argument is given, the current directory is listed. 
When several arguments are given, the arguments are first sorted appropriately, but 
file arguments appear before directories and their contents. 

There are three major listing formats. The default format is to list one entry per line, 
the -C and -x options enable multi-column formats, and the -m option enables 
stream output format. In order to determine output formats for the -C, -x, and -m 
options, Is uses an environment variable, COLUMNS, to determine the number of 
character positions available on one output line. If this variable is not set, the ter- 
minfo(i) database is used to determine the number of columns, based on the environ- 
ment variable TERM. If this information cannot be obtained, 80 columns are 
assumed. 

The Is command has the following options: 

-R 

-a 



Recursively list subdirectories encountered. 

List all entries, including those that begin with a dot (•), which are normally not 
listed. 

-d If an argument is a directory, list only its name (not its contents); often used 
with -1 to get the status of a directory. 

-C Multi-column output with entries sorted down the columns. 

~x Multi-column output with entries sorted across rather than down the page. 

-m Stream output format; files are listed across the page, separated by commas. 

-1 List in long format, giving mode, number of links, owner, group, size in bytes, 
and time of last modification for each file (see below). If the file is a special file, 
the size field will instead contain the major and minor device numbers rather 
than a size. 

-n The same as -1, except that the owner's UID and group's GID numbers are 
printed, rather than the associated character strings. 

-o The same as -1, except that the group is not printed. 

-g The same as -1, except that the owner is not printed. 

-r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

-t Sort by time stamp (latest first) instead of by name. The default is the last 
modification time. (See -n and -c.) 

-u Use time of last access instead of last modification for sorting (with the -t 
option) or printing (with the -1 option). 

-c Use time of last modification of the i-node (file created, mode changed, etc.) for 
sorting (-t) or printing (-1). 

-p Put a slash (/) after each filename if that file is a directory. 

-F Put a slash (/) after each filename if that file is a directory and put an asterisk (*) 
after each filename if that file is executable. 
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-b Force printing of non-graphic characters to be in the octal \ddd notation. 

-q Force printing of non-graphic characters in file names as the character (?). 

-i For each file, print the i-number in the first column of the report. 

-s Give size in blocks, including indirect blocks, for each entry. 

-f Force each argument to be interpreted as a directory and list the name found in 
each slot. This option turns off -1, -t, -s, and -r, and turns on -a; the order is 
the order in which entries appear in the directory. 

The mode printed under the -1 option consists of ten characters. The first character 
may be one of the following: 

d the entry is a directory; 

b the entry is a block special file; 

c the entry is a character special file; 

1 the entry is a symbolic link; 

p the entry is a fifo (a.k.a. "named pipe") special file; 
the entry is an ordinary file. 
The next 9 characters are interpreted as three sets of three bits each. The first set 
refers to the owner's permissions; the next to permissions of others in the user-group 
of the file; and the last to all others. Within each set, the three characters indicate per- 
mission to read, to write, and to execute the file as a program, respectively. For a 
directory, "execute" permission is interpreted to mean permission to search the direc- 
tory for a specified file. 

Is -1 (the long list) prints its output as follows: 

-rwxrwxrwx 1 smith dev 10876 May 16 9:42 part2 
lrwxrwxrwx 1 paul hum 23568 May 9 17:31 symfoo -> foo 

This horizontal configuration provides a good deal of information. Reading from 
right to left in the first example, you see that the current directory holds one file, 
named "part2." Next, the last time that file's contents were modified was 9:42 A.M. 
on May 16. The file is moderately sized, containing 10,876 characters, or bytes. The 
owner of the file, or the user, belongs to the group "dev" (perhaps indicating 
"development"), and his or her login name is "smith." The number, in this case "1," 
indicates the number of links to file "part2." Finally, the row of dash and letters tell 
you that user, group, and others have permissions to read, write, execute "part2." 
The second example shows how a symbolic link is displayed. The file symfoo is a 
symbolic link to the file foo. 

The execute (x) symbol here occupies the third position of the three-character 
sequence. A - in the third position would have indicated a denial of execution per- 
missions. 

The permissions are indicated as follows: 
r the file is readable 
w the file is writable 
x the file is executable 

the indicated permission is not granted 
1 mandatory locking will occur during access (the set-group-ID bit is on and 

the group execution bit is off) 
s the set-user-ID or set-group-ID bit is on, and the corresponding user or 

group execution bit is also on 
S undefined bit-state (the set-user-ID bit is on and the user execution bit if 
off) 



Stardent 1500/3000 261 



Essential Utilities 



LS(1) 



EXAMPLES 



FILES 

SEE ALSO 
BUGS 



LS(1) 



t the 1000 (octal) bit, or sticky bit, is on (see chmod(D), and execution is on 
T the 1000 bit is turned on, and execution is off (undefined bit-state) 

For user and group permissions, the third position is sometimes occupied by a char- 
acter other than x or -. s also may occupy this position, referring to the state of the 
set-ID bit, whether it be the user's or the group's. The ability to assume the same ID 
as the user during execution is, for example, used during login when you begin as 
root but need to assume the identity of the user stated at "login." 

In the case of the sequence of group permissions, 1 may occupy the third position. 1 
refers to mandatory file and record locking. This permission describes a file's ability 
to allow other files to lock its reading or writing permissions during access. 

For others permissions, the third position may be occupied by t or T. These refer to 
the state of the sticky bit and execution permissions. 



The first set of examples refers to permissions: 



-rwxr- 



-r — 



This describes a file that is readable, writable, and executable by the user and read- 
able by the group and others. 

-rwsr-xr-x 

The second example describes a file that is readable, writable, and executable by the 
user, readable and executable by the group and others, and allows its user-ID to be 
assumed, during execution, by the user presently executing it. 

-rw-rwl 

This example describes a file that is readable and writable only by the user and the 
group and can be locked during access. 

Is -a 

This command will print the names of all files in the current directory, including 
those that begin with a dot (.), which normally do not print. 

Is -aisn 

This command will provide you with quite a bit of information including all files, 
including non-printing ones (a), the i-number — the memory address of the i-node 
associated with the file— printed in the left-hand column (i); the size (in blocks) of the 
files, printed in the column to the right of the i-numbers (s); finally, the report is 
displayed in the numeric version of the long list, printing the UID (instead of user 
name) and GID (instead of group name) numbers associated with the files. 

When the sizes of the files in a directory are listed, a total count of blocks, including 
indirect blocks, is printed. 



/etc/passwd 

/etc/ group 

/usr/lib/terminfo/?/* 

chmod(l), find(l). 



user IDs for Is -1 and Is -o 
group IDs for Is -1 and Is -g 
terminal information database 



Unprintable characters in file names may confuse the columnar output options. 
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m4 - macro processor 

m4 [ options ] [ files ] 

The m4 command is a macro processor intended as a front end for Ratfor, C, and 
other languages. Each of the argument files is processed in order; if there are no files, 
or if a file name is -, the standard input is read. The processed text is written on the 
standard output. 

The options and their effects are as follows: 

-e Operate interactively. Interrupts are ignored and the output is unbuffered. 

-s Enable line sync output for the C preprocessor (#line . . . ) 

-Bint Change the size of the push-back and argument collection buffers from the 
default of 4,096. 

-Hint Change the size of the symbol table hash array from the default of 199. The 
size should be prime. 

-Sint Change the size of the call stack from the default of 100 slots. Macros take 
three slots, and non-macro arguments take one. 

-Tint Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before any -D or 
-U flags: 

-Dname[=val] 

Defines name to vol or to null in vol's absence. 

-Uname undeiines name. 

Macro calls have the form: 

name(argl,arg2, . . ., argn) 

The ( must immediately follow the name of the macro. If the name of a defined 
macro is not followed by a (, it is deemed to be a call of that macro with no argu- 
ments. Potential macro names consist of alphabetic letters, digits, and underscore _, 
where the first character is not a digit. 

Leading unquoted blanks, tabs, and new-lines are ignored while collecting argu- 
ments. Left and right single quotes are used to quote strings. The value of a quoted 
string is the string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by searching for a 
matching right parenthesis. If fewer arguments are supplied than are in the macro 
definition, the trailing arguments are taken to be null. Macro evaluation proceeds 
normally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call are as effective 
as those in the original input text. After argument collection, the value of the macro 
is pushed back onto the input stream and rescanned. 

m4 makes available the following built-in macros. They may be redefined, but once 
this is done the original meaning is lost. Their values are null unless otherwise 
stated. 

define the second argument is installed as the value of the macro whose 

name is the first argument. Each occurrence of %n in the replacement 
text, where n is a digit, is replaced by the n-th argument. Argument 
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is the name of the macro; missing arguments are replaced by the null 
string; $# is replaced by the number of arguments; $* is replaced by a 
list of all the arguments separated by commas; $@ is like $*, but each 
argument is quoted (with the current quotes). 

undefine removes the definition of the macro named in its argument. 

defn returns the quoted definition of its argument(s). It is useful for renam- 

ing macros, especially built-ins. 

pushdef like define, but saves any previous definition. 

popdef removes current definition of its argument(s), exposing the previous 

one, if any. 

ifdef if the first argument is defined, the value is the second argument, oth- 

erwise the third. If there is no third argument, the value is null. The 
word unix is predefined on UNIX system versions of m4 . 

shift returns all but its first argument. The other arguments are quoted and 

pushed back with commas in between. The quoting nullifies the effect 
of the extra scan that will subsequently be performed. 

changequote change quote symbols to the first and second arguments. The symbols 
may be up to five characters long. Changequote without arguments 
restores the original values (i.e., N '). 

changecom change left and right comment markers from the default # and new- 
line. With no arguments, the comment mechanism is effectively dis- 
abled. With one argument, the left marker becomes the argument and 
the right marker becomes new-line. With two arguments, both mark- 
ers are affected. Comment markers may be up to five characters long. 

divert m4 maintains 10 output streams, numbered 0-9. The final output is 

the concatenation of the streams in numerical order; initially stream 
is the current stream. The divert macro changes the current output 
stream to its (digit-string) argument. Output diverted to a stream 
other than through 9 is discarded. 

undivert causes immediate output of text from diversions named as arguments, 

or all diversions if no argument. Text may be undiverted into another 
diversion. Undiverting discards the diverted text. 

divnum returns the value of the current output stream. 

dnl reads and discards characters up to and including the next new-line. 

ifelse has three or more arguments. If the first argument is the same string 

as the second, then the value is the third argument. If not, and if there 
are more than four arguments, the process is repeated with arguments 
4, 5, 6 and 7. Otherwise, the value is either the fourth string, or, if it is 
not present, null. 

incr returns the value of its argument incremented by 1. The value of the 

argument is calculated by interpreting an initial digit-string as a 
decimal number. 

deer returns the value of its argument decremented by 1. 

eval evaluates its argument as an arithmetic expression, using 32-bit arith- 

metic. Operators include +, -, *, /, %, A (exponentiation), bitwise &, I , 
A , and ~; relationals; parentheses. Octal and hex numbers may be 
specified as in C. The second argument specifies the radix for the 
result; the default is 10. The third argument may be used to specify 
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the minimum number of digits in the result. 

len returns the number of characters in its argument. 

index returns the position in its first argument where the second argument 

begins (zero origin), or -1 if the second argument does not occur. 

substr returns a substring of its first argument. The second argument is a 

zero origin number selecting the first character; the third argument 
indicates the length of the substring. A missing third argument is 
taken to be large enough to extend to the end of the first string. 

translit transliterates the characters in its first argument from the set given by 

the second argument to the set given by the third. No abbreviations 
are permitted. 

include returns the contents of the file named in the argument. 

sinclude is identical to include, except that it says nothing if the file is inaccessi- 

ble. 

syscmd executes the UNIX system command given in the first argument. No 

value is returned. 

sysval is the return code from the last call to syscmd . 

maketemp fills in a string of XXXXX in its argument with the current process ID. 

m4exit causes immediate exit from m4. Argument 1, if given, is the exit code; 

the default is 0. 

m4wrap argument 1 will be pushed back at final EOF; example: 

m4wrap( s cleanup( ) ') 

errprint prints its argument on the diagnostic output file. 

dumpdef prints current names and definitions, for the named items, or for all if 
no arguments are given. 

traceon with no arguments, turns on tracing for all macros (including built- 

ins). Otherwise, turns on tracing for named macros. 

traceoff turns off trace globally and for any macros specified. Macros 

specifically traced by traceon can be untraced only by specific calls to 

traceoff. 

cc(l),cpp(l). 

The mi Macro Processor in the Support Tools Guide. 
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machid: titan, mips, m68000, pdpll, u3b, u3b2, u3b5, vax - get processor type truth 
value 

titan 

mips 

m68000 

pdpll 

u3b 

u3b2 

u3b5 

vax 

The following commands return a true value (exit code of 0) if you are using a pro- 
cessor that the command name indicates. 

titan True for the Stardent Computer Inc. Stardent 1500/3000 graphics 
supercomputer. 

mips True for a MIPS M/ series computer. 

m68000 

True for a Motorola 680x0 series processor. 

pdpll True for a PDP-11/45 or PDP-11/70. 

u3b True for a 3B20 computer. 

u3b2 True for a 3B2 computer. 

u3b5 True for a 3B5 computer. 

vax True for a VAX-1 1/750 or VAX-1 1/780. 

The commands that do not apply return a false (non-zero) value. These commands 
are often used within makefiles (see make(D) and shell procedures (see sh(D) to 
increase portability. 

sh(l), make(l), test(l), true(l). 
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mail, rmail - send mail to users or read mail 

Sending mail: 

mail [ --oswt ] persons 

rmail [ -oswt ] persons 

Reading mail: 

mail [ -ehpqr ] [ -f file ] [ -F persons ] 

Sending mail: 

The command-line arguments that follow affect SENDING mail: 

-o suppresses the address optimization facility. 

-s suppresses the addition of a <new-line> at the top of the letter being sent. See 
WARNINGS below. 

-w causes a letter to be sent to a remote user without waiting for the completion of 
the remote transfer program. 

-t causes a To: line to be added to the letter, showing the intended recipients. 

A person is usually a user name recognized by login(l). When persons are named, 
mail assumes a message is being sent (except in the case of the /-F option). It reads 
from the standard input up to an end-of-file (control-d), or until it reads a line con- 
sisting of just a period. When either of those signals is received, mail adds the letter to 
the mailfile for each person. A letter is a message preceded by a postmark. The message 
is preceded by the sender's name and a postmark. A postmark consists of one or more 
'From' lines followed by a blank line (unless the -s argument was used). 

If a letter is found to be undeliverable, it is returned to the sender with diagnostics 
that indicate the location and nature of the failure. If mail is interrupted during 
input, the file deadJetter is saved to allow editing and resending. dead.letter is 
recreated every time it is needed, erasing any previous contents. 

rmail only permits the sending of mail; uucp (1C) uses rmail as a security precaution. 

If the local system has the Basic Networking Utilities installed, mail may be sent to a 
recipient on a remote system. Prefix person by the system name and exclamation 
point. A series of system names separated by exclamation points can be used to 
direct a letter through an extended network. 

Reading Mail: 

The command-line arguments that follow affect READING mail: 

-e causes mail not to be printed. An exit value of is returned if the user has mail; 
otherwise, an exit value of 1 is returned. 

-h causes a window of headers to be displayed rather than the latest message. The 
display is followed by the '?' prompt. 

-p causes all messages to be printed without prompting for disposition. 

-q causes mail to terminate after interrupts. Normally an interrupt causes only the 
termination of the message being printed. 

-r causes messages to be printed in first-in, first-out order. 
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-(file causes mail to use file (e.g., mbox) instead of the default mailfile. 

-Upersons 

entered into an empty mailbox, causes all incoming mail to be forwarded to per- 
sons. 

mail , unless otherwise influenced by command-line arguments, prints a user's mail 
messages in last-in, first-out order. For each message, the user is prompted with a ?, 
and a line is read from the standard input. The following commands are available to 
determine the disposition of the message: 

<new-line>, +, or n Go on to next message. 

d, or dp Delete message and go on to next message. 

d # Delete message number #. Do not go on to next message. 

dq Delete message and quit mail 

h Display a window of headers around current message. 

h # Display header of message number #. 

h a Display headers of ALL messages in the user's mailfile. 

h d Display headers of messages scheduled for deletion. 

p Print current message again. 

- Print previous message. 

a Print message that arrived during the mail session. 

# Print message number #. 

r [ users ] Reply to the sender, and other user(s), then delete the mes- 

sage. 

s [ files ] Save message in the named files (mbox is default). 

y Same as save. 

u [■ # ] Undelete message number # (default is last read). 

w [ files ] Save message, without its top-most header, in the named 

files (mbox is default). 

m [ persons ] Mail the message to the named persons . 

q, or ctl-d Put undeleted mail back in the mailfile and quit mail. 

x Put all mail back in the mailfile unchanged and exit mail 

kommand Escape to the shell to do command . 

7 Print a command summary. 

When a user logs in, the presence of mail, if any, is indicated. Also, notification is 
made if new mail arrives while using mail. 

The mailfile may be manipulated in two ways to alter the function of mail. The other 
permissions of the file may be read-write, read-only, or neither read nor write to 
allow different levels of privacy. If changed to other than the default, the file will be 
preserved even when empty to perpetuate the desired permissions. The file may also 
contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded to person. 
A "Forwarded by..." message is added to the header. This is especially useful in a 
multi-machine environment to forward all of a person's mail to a single machine, and 
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to keep the recipient informed if the mail has been forwarded. Installation and remo- 
val of forwarding is done with the -F option. 

To forward all of one's mail to systemaluser enter: 

mail -Fsystemaluser 
To forward to more than one user enter: 

mail-F"userl,systema!user2,systema!systemb!user3" 

Note that when more than one user is specified, the whole list should be enclosed in 
double quotes so that it may all be interpreted as the operand of the -F option. The 
list can be up to 1024 bytes; either commas or white space can be used to separate 
users. 

To remove forwarding enter: 

mail-F"" 

The pair of double quotes is mandatory to set a NULL argument for the -F option. 

In order for forwarding to work properly the mailfile should have "mail" as group ID, 
and the group permission should be read-write. 



/bin/mail 

/etc/passwd 

/usr/ mail /user 

$HOME/mbox 

$MAIL 

/tmp/ma* 

/usr/mail/*.lock 

deadJetter 



to identify sender and locate persons 

incoming mail for user; i.e., the mailfile 

saved mail 

variable containing path name of mailfile 

temporary file 

lock for mail directory 

unmailable text 



login(l), mailx(l), write(l). 

User s Guide. 

System Administrator's Guide. 

The "Forward to person" feature may result in a loop, if syslluserb forwards to 
syslluserb and syslluserb forwards to syslluserb. The symptom is a message saying 
"unbounded.. .saved mail in dead.letter." 

The -s option should be used with caution. It allows the text of a message to be 
interpreted as part of the postmark of the letter, possibly causing confusion to other 
mail programs. To allow compatibility with mailx{\), if the first line of the message is 
"Subject:...", the addition of a <newline> is suppressed whether or not the -s option is 
used. 

Conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be forced by 

typing a p. 
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DESCRIPTION 



MAILX(i) 



mailx - interactive message processing system 

mailx [options] [name...] 

The command mailx provides a comfortable, flexible environment for sending and 
receiving messages electronically. When reading mail, mailx provides commands to 
facilitate saving, deleting, and responding to messages. When sending mail, mailx 
allows editing, reviewing and other modification of the message as it is entered. 

Many of the remote features of mailx will only work if the Basic Networking Utilities 
are installed on your system. 

Incoming mail is stored in a standard file for each user, called the mailbox for that 
user. When mailx is called to read messages, the mailbox is the default place to find 
them. As messages are read, they are marked to be moved to a secondary file for 
storage, unless specific action is taken, so that the messages need not be seen again. 
This secondary file is called the mbox and is normally located in the user's HOME 
directory (see "MBOX" (ENVIRONMENT VARIABLES) for a description of this file). 
Messages can be saved in other secondary files named by the user. Messages remain 
in a secondary file until forcibly removed. 

The user can access a secondary file by using the -f option of the mailx command. 
Messages in the secondary file can then be read or otherwise processed using the 
same COMMANDS as in the primary mailbox. This gives rise within these pages to the 
notion of a current mailbox. 

On the command line, options start with a dash (-) and any other arguments are 
taken to be destinations (recipients). If no recipients are specified, mailx will attempt 
to read messages from the mailbox. Command line options are: 



-e 



-f [filename] 
-F 

-h number 



-H 

-i 

-n 

-N 

-r address 

-s subject 
-u user 

-U 



Test for presence of mail, mailx prints nothing and exits with a 
successful return code if there is mail to read. 
Read messages from filename instead of mailbox. If no filename is 
specified, the mbox is used. 

Record the message in a file named after the first recipient. 
Overrides the "record" variable, if set (see ENVIRONMENT 
VARIABLES). 

The number of network "hops" made so far. This is provided 
for network software to avoid infinite delivery loops. (See 
addsopt under ENVIRONMENT VARIABLES) 
Print header summary only. 

Ignore interrupts. See also "ignore" (ENVIRONMENT VARI- 
ABLES). 

Do not initialize from the system default mailx.rc file. 
Do not print initial header summary. 

Pass address to network delivery software. All tilde commands 
are disabled. (See addsopt under ENVIRONMENT VARIABLES) 
Set the Subject header field to subject. 

Read user's mailbox. This is only effective if user's mailbox is not 
read protected. 

Convert uucp style addresses to internet standards. Overrides 
the "conv" environment variable. (See addsopt under 
ENVIRONMENT VARIABLES) 
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When reading mail, mailx is in command mode. A header summary of the first several 
messages is displayed, followed by a prompt indicating mailx can accept regular 
commands (see COMMANDS below). When sending mail, mailx is in input mode. If 
no subject is specified on the command line, a prompt for the subject is printed. (A 
"subject" longer than 1024 characters will cause mailx to dump core) As the message 
is typed, mailx will read the message and store it in a temporary file. Commands 
may be entered by beginning a line with the tilde (~) escape character followed by a 
single command letter and optional arguments. See TILDE ESCAPES for a summary 
of these commands. 

At any time, the behavior of mailx is governed by a set of environment variables. These 
are flags and valued parameters which are set and cleared via the set and unset com- 
mands. See ENVIRONMENT VARIABLES below for a summary of these parameters. 

Recipients listed on the command line may be of three types: login names, shell com- 
mands, or alias groups. Login names may be any network address, including mixed 
network addressing. If mail is found to to undeliverable, an attempt is made to 
return it to the sender's mailbox. If the recipient name begins with a pipe symbol ( I 
), the rest of the name is taken to be a shell command to pipe the message through. 
This provides an automatic interface with any program that reads the standard 
input, such as lp(l) for recording outgoing mail on paper. Alias groups are set by the 
alias command (see COMMANDS below) and are lists of recipients of any type. 

Regular commands are of the form 

[ command ] [ msglist ] [ arguments ] 

If no command is specified in command mode, print is assumed. In input mode, com- 
mands are recognized by the escape character, and lines not treated as commands are 
taken as input for the message. 

Each message is assigned a sequential number, and there is at any time the notion of 
a current message, marked by a right angle bracket (>) in the header summary. 
Many commands take an optional list of messages {msglist) to operate on. The default 
for msglist is the current message. A msglist is a list of message identifiers separated 
by spaces, which may include: 

n Message number n. 

The current message. 
A The first undeleted message. 

$ The last message. 

* All messages. 

n-m An inclusive range of message numbers. 
user All messages from user. 

/string All messages with string in the subject line (case ignored). 
\c All messages of type c, where c is one of: 

d deleted messages 

n new messages 

o old messages 

r read messages 

u unread messages Note that the context of the command 
determines whether this type of message specification makes sense. 

Other arguments are usually arbitrary strings whose usage depends on the com- 
mand involved. File names, where expected, are expanded via the normal shell con- 
ventions (see sh(V)). Special characters are recognized by certain commands and are 
documented with the commands below. 
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COMMANDS 



At start-up time, mailx tries to execute commands from the optional system- wide file 
(/usr/lib/mailx/mailx.rc) to initialize certain parameters, then from a private start-up 
file ($HOME/.mailrc) for personalized variables. With the exceptions noted below, 
regular commands are legal inside start-up files. The most common use of a start-up 
file is to set up initial display options and alias lists. The following commands are 
not legal in the start-up file: !, Copy, edit, f ollowup, Followup, hold, mail, preserve, 
reply, Reply, shell, and visual. An error in the start-up file causes the remaining lines 
in the file to be ignored. The .mailrc file is optional, and must be constructed locally. 

The following is a complete list of mailx commands: 

Ishell-command 

Escape to the shell. See "SHELL" (ENVIRONMENT VARIABLES). 

# comment 

Null command (comment). This may be useful in .mailrc files. 



Print the current message number. 



Prints a summary of commands. 



alias alias name ... 
group alias name ... 

Declare an alias for the given names. The names will be substituted when alias 

is used as a recipient. Useful in the .mailrc file. 

alternates name ... 

Declares a list of alternate names for your login. When responding to a mes- 
sage, these names are removed from the list of recipients for the response. 
With no arguments, alternates prints the current list of alternate names. See 
also "allnet" (ENVIRONMENT VARIABLES). 



( 



cd [directory] 
chdir [directory] 

Change directory. 



If directory is not specified, $HOME is used. 



copy [filename] 

copy [msglist] filename 

Copy messages to the file without marking the messages as saved. Otherwise 

equivalent to the save command. 

Copy [msglist] 

Save the specified messages in a file whose name is derived from the author of 
the message to be saved, without marking the messages as saved. Otherwise 
equivalent to the Save command. 

delete [msglist] 

Delete messages from the mailbox. If "autoprint" is set, the next message after 
the last one deleted is printed (see ENVIRONMENT VARIABLES). 
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discard [header- field ...] 

ignore [header- field ...] 

Suppresses printing of the specified header fields when displaying messages on 
the screen. Examples of header fields to ignore are "status" and "cc." The fields 
are included when the message is saved. The Print and Type commands over- 
ride this command. 

dp [msglist] 

dt [msglist] 

Delete the specified messages from the mailbox and print the next message after 
the last one deleted. Roughly equivalent to a delete command followed by a 
print command. 

echo string ... 

Echo the given strings (like echo (I)). 

edit [msglist] 

Edit the given messages. The messages are placed in a temporary file and the 
"EDITOR" variable is used to get the name of the editor (see ENVIRONMENT 
VARIABLES). Default editor is ed(l). 

exit 
xit 

Exit from mailx, without changing the mailbox. No messages are saved in the 

mbox (see also quit). 

file [filename] 
folder [filename] 

Quit from the current file of messages and read in the specified file. Several 
special characters are recognized when used as file names, with the following 
substitutions: 

% the current mailbox. 
%user 

the mailbox for user. 
# the previous file. 
& the current mbox. Default file is the current mailbox. 

folders 

Print the names of the files in the directory set by the "folder" variable (see 

ENVIRONMENT VARIABLES). 

followup [message] 

Respond to a message, recording the response in a file whose name is derived 
from the author of the message. Overrides the "record" variable, if set. See also 
the Followup, Save, and Copy commands and "outfolder" (ENVIRONMENT 
VARIABLES). 

Followup [msglist] 

Respond to the first message in the msglist, sending the message to the author 
of each message in the msglist. The subject line is taken from the first message 
and the response is recorded in a file whose name is derived from the author of 
the first message. See also the followup, Save, and Copy commands and "out- 
folder" (ENVIRONMENT VARIABLES). 
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from [msglist] § 

"0»»-S-»"»4-/-i -M-* /-* V\rtn/lrti« r>i -iw\wt «-»*»* t £nt* 4-p\n a tonsil fin A ■S'v* ooc rs rrtsc ^~ 



i [msgltsti 
Prints the header summary for the specified messages. 



group alias name ... 
dims alias name ... 

Declare an alias for the given names. The names will be substituted when alias 

is used as a recipient. Useful in the .mailrc file. 

headers [message] 

Prints the page of headers which includes the message specified. The "screen" 
variable sets the number of headers per page (see ENVIRONMENT VARIABLES). 
See also the z command. 

help 

Prints a summary of commands. 

hold [msglist] 
preserve [msglist] 

Holds the specified messages in the mailbox. 

Us I r 

mail-commands 

else 

mail-commands 

endif 

Conditional execution, where s will execute following mail-commands, up to an ^ 

else or endif, if the program is in send mode, and r causes the mail-commands to f 

be executed only in receive mode. Useful in the .mailrc file. 

ignore header- field ... 

discard header-field ... 

Suppresses printing of the specified header fields when displaying messages on 
the screen. Examples of header fields to ignore are "status" and "cc." All fields 
are included when the message is saved. The Print and Type commands over- 
ride this command. 



list 



Prints all commands available. No explanation is given. 



mail name ... 

Mail a message to the specified users. 

Mail name 

Mail a message to the specified user and record a copy of it in a file named after 
that user. 

mbox [msglist] 

Arrange for the given messages to end up in the standard mbox save file when 
mailx terminates normally. See "MBOX" (ENVIRONMENT VARIABLES) for a 
description of this file. See also the exit and quit commands. 



c 
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next [message] 

Go to next message matching message. A msglist may be specified, but in this 
case the first valid message in the list is the only one used. This is useful for 
jumping to the next message from a specific user, since the name would be 
taken as a command in the absence of a real command. See the discussion of 
msglists above for a description of possible message specifications. 

pipe [msglist] [shell-command] 

I [msglist] [shell-command] 

Pipe the message through the given shell-command. The message is treated as if 
it were read. If no arguments are given, the current message is piped through 
the command specified by the value of the "and" variable. If the "page" vari- 
able is set, a form feed character is inserted after each message (see ENVIRON- 
MENT VARIABLES). 

preserve [msglist] 
hold [msglist] 

Preserve the specified messages in the mailbox. 

Print [msglist] 

Type [msglist] 

Print the specified messages on the screen, including all header fields. Over- 
rides suppression of fields by the ignore command. 

print [msglist] 

type [msglist] 

Print the specified messages. If "crt" is set, the messages longer than the 
number of lines specified by the "crt" variable are paged through the command 
specified by the "PAGER" variable. The default command is pg(l) (see 
ENVIRONMENT VARIABLES). 



quit 

Exit from mailx, storing messages that were read in mbox and unread messages 
in the mailbox. Messages that have been explicitly saved in a file are deleted. 

Reply [msglist] 

Respond [msglist] 

Send a response to the author of each message in the msglist. The subject line is 
taken from the first message. If "record" is set to a file name, the response is 
saved at the end of that file (see ENVIRONMENT VARIABLES). 

reply [message] 

respond [message] 

Reply to the specified message, including all other recipients of the message. If 
"record" is set to a file name, the response is saved at the end of that file (see 
ENVIRONMENT VARIABLES). 

Save [msglist] 

Save the specified messages in a file whose name is derived from the author of 
the first message. The name of the file is taken to be the author's name with all 
network addressing stripped off. See also the Copy, followup, and Followup 
commands and "outfolder" (ENVIRONMENT VARIABLES). 
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save [filename] § 

save [msglist] filename ^ 

Save the specified messages in the given file. The file is created if it does not 
exist. The message is deleted from the mailbox when mailx terminates unless 
"keepsave" is set (see also ENVIRONMENT VARIABLES and the exit and quit 
commands). 

set 

set name 

set name-string 

set name-number 

Define a variable called name. The variable may be given a null, string, or 
numeric value. Set by itself prints all defined variables and their values. See 
ENVIRONMENT VARIABLES for detailed descriptions of the mailx variables. 

shell 

Invoke an interactive shell (see also "SHELL" (ENVIRONMENT VARIABLES)). 

size [msglist] 

Print the size in characters of the specified messages. 

source filename 

Read commands from the given file and return to command mode. 

top [msglist] 

Print the top few lines of the specified messages. If the "toplines" variable is set, ^ 

it is taken as the number of lines to print (see ENVIRONMENT VARIABLES). The I 

default is 5. 

touch [msglist] 

Touch the specified messages. If any message in msglist is not specifically saved 
in a file, it will be placed in the mbox upon normal termination. See exit and 
quit. 

Type [msglist] 

Print [msglist] 

Print the specified messages on the screen, including all header fields. Over- 
rides suppression of fields by the ignore command. 

type [msglist] 

print [msglist] 

Print the specified messages. If "crt" is set, the messages longer than the 
number of lines specified by the "crt" variable are paged through the command 
specified by the "PAGER" variable. The default command is pg(l) (see 
ENVIRONMENT VARIABLES). 

undelete [msglist] 

Restore the specified deleted messages. Will only restore messages deleted in 
the current mail session. If "autoprint" is set, the last message of those restored 
is printed (see ENVIRONMENT VARIABLES). 
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unset name ... 

Causes the specified variables to be erased. If the variable was imported from 
the execution environment (i.e., a shell variable) then it cannot be erased. 

version 

Prints the current version and release date. 

visual [msglisi] 

Edit the given messages with a screen editor. The messages are placed in a 
temporary file and the "VISUAL" variable is used to get the name of the editor 
(see ENVIRONMENT VARIABLES). 

write [msglist] filename 

Write the given messages on the specified file, minus the header and trailing 
blank line. Otherwise equivalent to the save command. 

xit 
exit 

Exit from mailx, without changing the mailbox. No messages are saved in the 

mbox (see also quit). 

z[+ I -] 

Scroll the header display forward or backward one screen-full. The number of 
headers displayed is set by the "screen" variable (see ENVIRONMENT VARI- 
ABLES). 

TILDE ESCAPES 

The following commands may be entered only from input mode, by beginning a line 
with the tilde escape character (~). See "escape" (ENVIRONMENT VARIABLES) for 
changing this special character. 

~ ! shell-command 

Escape to the shell. 

Simulate end of file (terminate message input). 

~: mail-command 
~_ mail-command 

Perform the command-level request. Valid only when sending a message while 

reading mail. 

~? 

Print a summary of tilde escapes. 

~A 

Insert the autograph string "Sign" into the message (see ENVIRONMENT VARI- 
ABLES). 

~a 

Insert the autograph string "sign" into the message (see ENVIRONMENT VARI- 
ABLES). 
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~bname... 

Add the names to the blind carbon copy (Bcc) list. 

-cname ... 

Add the names to the carbon copy (Cc) list. 

~d 

Read in the dead.letter file. See "DEAD" (ENVIRONMENT VARIABLES) for a 
description of this file. 

~e 

Invoke the editor on the partial message. See also "EDITOR" (ENVIRONMENT 
VARIABLES). 

~f[msgli$t] 

Forward the specified messages. The messages are inserted into the message, 
without alteration. 

~h 

Prompt for Subject line and To, Cc, and Bcc lists. If the field is displayed with 
an initial value, it may be edited as if you had just typed it. 

~i string 

Insert the value of the named variable into the text of the message. For exam- 
ple, ~A is equivalent to '~i Sign/ 

~m [msglist] 

Insert the specified messages into the letter, shifting the new text to the right 
one tab stop. Valid only when sending a message while reading mail. 

~p 

Print the message being entered. 

~q 

Quit from input mode by simulating an interrupt. If the body of the message is 
not null, the partial message is saved in dead.letter. See "DEAD" (ENVIRON- 
MENT VARIABLES) for a description of this file. 

~r filename 

~~ < filename 

~~< Ishell-command 

Read in the specified file. If the argument begins with an exclamation point (!), 
the rest of the string is taken as an arbitrary shell command and is executed, 
with the standard output inserted into the message. 

~s string... 

Set the subject line to string. 

-tname... 

Add the given names to the To list. 
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Invoke a preferred screen editor on the partial message. See also "VISUAL" 
(ENVIRONMENT VARIABLES). 

~w filename 

Write the partial message onto the given file, without the header. 

~x 

Exit as with ~q except the message is not saved in dead.letter. 

~ I shell-command 

Pipe the body of the message through the given shell-command. If the shell- 
command returns a successful exit status, the output of the command replaces 
the message. 

ENVIRONMENT VARIABLES 

The following are environment variables taken from the execution environment and 
are not alterable within mailx. 

HOME=directory 

The user's base of operations. 

MAlLRC=filename 

The name of the start-up file. Default is $HOME/.mailrc. 

The following variables are internal mailx variables. They may be imported from the 
execution environment or set via the set command at any time. The unset command 
may be used to erase variables. 

addsopt 

Enabled by default. If /bin/mail is not being used as the deliverer, noaddsopt 
should be specified. (See WARNINGS below) 

allnet 

All network names whose last component (login name) match are treated as 
identical. This causes the msglist message specifications to behave similarly. 
Default is noallnet. See also the alternates command and the "metoo" variable. 

append 

Upon termination, append messages to the end of the mbox file instead of 
prepending them. Default is noappend. 

askcc 

Prompt for the Cc list after message is entered. Default is noaskcc. 

asksub 

Prompt for subject if it is not specified on the command line with the -s option. 
Enabled by default. 

autoprint 

Enable automatic printing of messages after delete and undelete commands. 
Default is noautoprint. 
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bang 

Enable the special-casing of exclamation points (!) in shell escape command 
lines as in w(l). Default is nobang. 

cm&=shell-command 

Set the default command for the pipe command. No default value. 

conv=conversion 

Convert uucp addresses to the specified address style. The only valid conver- 
sion now is internet, which requires a mail delivery program conforming to the 
RFC822 standard for electronic mail addressing. Conversion is disabled by 
default. See also "sendmail" and the -U command line option. 

ctt=number 

Pipe messages having more than number lines through the command specified 
by the value of the "PAGER" variable (pg(l) by default). Disabled by default. 

VEAD^filename 

The name of the file in which to save partial letters in case of untimely inter- 
rupt. Default is $HOME/dead.letter. 

debug 

Enable verbose diagnostics for debugging. Messages are not delivered. 
Default is nodebug. 

dot 

Take a period on a line by itself during input from a terminal as end-of-file. 
Default is nodot. 

EDITOR-shell-command 

The command to run when the edit or ~e command is used. Default is ed(l). 

escape=c 

Substitute c for the ~ escape character. Takes effect with next message sent. 

folder-directory 

The directory for saving standard mail files. User-specified file names begin- 
ning with a plus (+) are expanded by preceding the file name with this direc- 
tory name to obtain the real file name. If directory does not start with a slash 
(/), $HOME is prepended to it. In order to use the plus (+) construct on a mailx 
command line, "folder" must be an exported sh environment variable. There is 
no default for the "folder" variable. See also "outfolder" below. 

header 

Enable printing of the header summary when entering mailx. Enabled by 
default. 

hold 

Preserve all messages that are read in the mailbox instead of putting them in the 
standard mbox save file. Default is nohold. 

ignore 

Ignore interrupts while entering messages. Handy for noisy dial-up lines. 
Default is noignore. 
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ignoreeof 

Ignore end-of-file during message input. Input must be terminated by a period 
(.) on a line by itself or by the ~. command. Default is noignoreeof. See also 
"dot" above. 

keep 

When the mailbox is empty, truncate it to zero length instead of removing it. 
Disabled by default. 

keepsave 

Keep messages that have been saved in other files in the mailbox instead of 
deleting them. Default is nokeepsave. 

MBOX=filename 

The name of the file to save messages which have been read. The xit command 
overrides this function, as does saving the message explicitly in another file. 
Default is $HOME/mbox. 

metoo 

If your login appears as a recipient, do not delete it from the list. Default is 
nometoo. 

USTER=shell-command 

The command (and options) to use when listing the contents of the "folder" 
directory. The default is Zs(l). 

onehop 

When responding to a message that was originally sent to several recipients, 
the other recipient addresses are normally forced to be relative to the originat- 
ing author's machine for the response. This flag disables alteration of the reci- 
pients' addresses, improving efficiency in a network where all machines can 
send directly to all other machines (i.e., one hop away). 

outfolder 

Causes the files used to record outgoing messages to be located in the directory 
specified by the "folder" variable unless the path name is absolute. Default is 
nooutf older. See "folder" above and the Save, Copy, folio wup, and Folio wup 
commands. 

page 

Used with the pipe command to insert a form feed after each message sent 
through the pipe. Default is nopage. 

FAGER=shell-command 

The command to use as a filter for paginating output. This can also be used to 
specify the options to be used. Default is pg(l). 

prompt=sfring 

Set the command mode prompt to string. Default is "? ". 

quiet 

Refrain from printing the opening message and version when entering mailx. 
Default is noquiet. 
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lecotd^filename 

Record all outgoing mail in filename. Disabled by default. See also "outfolder" 
above. 



( 



save 

Enable saving of messages in dead. letter on interrupt or delivery error. See 
"DEAD" for a description of this file. Enabled by default. 

scteen=number 

Sets the number of lines in a screen-full of headers for the headers command. 



FILES 



SEE ALSO 
WARNINGS 

BUGS 



sendmzLil=shell-command 

Alternate command for delivering messages. Default is mail(l). 

sendwait 

Wait for background mailer to finish before returning. Default is nosendwait. 

SHELL=shell-cotnmand 

The name of a preferred command interpreter. Default is.sft(l). 

showto 

When displaying the header summary and the message is from you, print the 
recipient's name instead of the author's name. 

sign=string 

The variable inserted into the text of a message when the -a (autograph) com- 
mand is given. No default (see also ~i (TILDE ESCAPES)). 

Sign-string 

The variable inserted into the text of a message when the ~A command is 
given. No default (see also ~i (TILDE ESCAPES)). 

toplines=tturafrer 

The number of lines of header to print with the top command. Default is 5. 

VISU AL-shell-command 

The name of a preferred screen editor. Default is vi(l). 

$HOME / .mailrc personal start-up file 

$HOME / mbox secondary storage file 

/usr/mail/* post office directory 

/usr/lib/mailx/mailx.help* help message files 

/usr/lib/mailx/mailx.rc optional global start-up file 

/tmp/R[emqsx]* temporary files 

ls(l),mail(l),pg(l). 

The -h, -r and -U options can be used only if mailx is built with a delivery program 
other than /bin/mail . 

Where shell-command is shown as valid, arguments are not always allowed. Experi- 
mentation is recommended. 
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Internal variables imported from the execution environment cannot be unset. 

The full internet addressing is not fully supported by mailx. The new standards need 
some time to settle down. 

Attempts to send a message having a line consisting only of a "." are treated as the 
end of the message by mail(l) (the standard mail delivery program). 
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make - maintain, update, and regenerate groups of programs 

make [-f makefile] [-p] R] [-k] [-s] [-r] [-n] [-b] he] [-u] [-t] [-q] [names] 

The make command allows the programmer to maintain, update, and regenerate 
groups of computer programs. The following is a brief description of all options and 
some special names: 

-f makefile Description file name, makefile is assumed to be the name of a descrip- 
tion file. 

-p Print out the complete set of macro definitions and target descriptions. 

-i Ignore error codes returned by invoked commands. This mode is 

entered if the fake target name .IGNORE appears in the description file. 

-k Abandon work on the current entry if it fails, but continue on other 

branches that do not depend on that entry. 

-s Silent mode. Do not print command lines before executing. This mode 

is also entered if the fake target name .SILENT appears in the description 
file. 

-r Do not use the built-in rules. 

-n No execute mode. Print commands, but do not execute them. Even lines 

beginning with an @ are printed. 

-b Compatibility mode for old makefiles. 

-e Environment variables override assignments within makefiles. 

-u Force an unconditional update. 

-t Touch the target files (causing them to be up-to-date) rather than issue 

the usual commands. 

-q Question. The make command returns a zero or non-zero status code 

depending on whether the target file is or is not up-to-date. 

.DEFAULT If a file must be made but there are no explicit commands or relevant 
built-in rules, the commands associated with the name .DEFAULT are 
used if it exists. 

.PRECIOUS Dependents of this target will not be removed when quit or interrupt are 
hit. 

.SILENT Same effect as the -s option. 

.IGNORE Same effect as the -i option. 

make executes commands in makefile to update one or more target names. Name is 
typically a program. If no -f option is present, makefile, Makefile, and the Source 
Code Control System(SCCS) files s.makefile, and s.Makefile are tried in order. If 
makefile is -, the standard input is taken. More than one - makefile argument pair may 
appear. 

make updates a target only if its dependents are newer than the target (unless the -u 
option is used to force an unconditional update). All prerequisite files of a target are 
added recursively to the list of targets. Missing files are deemed to be out-of-date. 

makefile contains a sequence of entries that specify dependencies. The first line of an 
entry is a blank-separated, non-null list of targets, then a :, then a (possibly null) list 
of prerequisite files or dependencies. Text following a ; and all following lines that 
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begin with a tab are shell commands to be executed to update the target. The first 
non-empty line that does not begin with a tab or # begins a new dependency or 
macro definition. Shell commands may be continued across lines with the 
<backslashxnew-line> sequence. Everything printed by make (except the initial 
tab) is passed directly to the shell as is. Thus, 

echo a\ 
b 

will produce 

ab 

exactly the same as the shell would. 

Sharp (#) and new-line surround comments. 

The following makefile says that pgm depends on two files a.o and b.o, and that they 
in turn depend on their corresponding source files (a.c and b.c) and a common file 
incLh: 

pgm: a.o b.o 

cc a.o b.o -o pgm 
a.o: incl.h a.c 

cc -c a.c 
b.o: incl.h b.c 

cc -c b.c 

Command lines are executed one at a time, each by its own shell. The SHELL 
environment variable can be used to specify which shell make should use to execute 
commands. The default is /bin/sh. The first one or two characters in a command can 
be the following: -, @, -@, or @-. If @ is present, printing of the command is 
suppressed. If - is present, make ignores an error. A line is printed when it is exe- 
cuted unless the -s option is present, or the entry .SILENT: is in makefile, or unless the 
initial character sequence contains a @. The -n option specifies printing without exe- 
cution; however, if the command line has the string $(MAKE) in it, the line is always 
executed (see discussion of the MAKEFLAGS macro under Environment). The -t 
(touch) option updates the modified date of a file without executing any commands. 

Commands returning non-zero status normally terminate make. If the -i option is 
present, or the entry .IGNORE: appears in makefile, or the initial character sequence of 
the command contains -. the error is ignored. If the -k option is present, work is 
abandoned on the current entry, but continues on other branches that do not depend 
on that entry. 

The -b option allows old makefiles (those written for the old version of make) to run 
without errors. 

Interrupt and quit cause the target to be deleted unless the target is a dependent of 
the special name .PRECIOUS. 

The environment is read by make. All variables are assumed to be macro definitions 
and processed as such. The environment variables are processed before any makefile 
and after the internal rules; thus, macro assignments in a makefile override environ- 
ment variables. The -e option causes the environment to override the macro assign- 
ments in a makefile. Suffixes and their associated rules in the makefile will override 
any identical suffixes in the built-in rules. 

The MAKEFLAGS environment variable is processed by make as containing any legal 
input option (except -f and -p) defined for the command line. Further, upon invoca- 
tion, make "invents" the variable if it is not in the environment, puts the current 
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options into it, and passes it on to invocations of commands. Thus, MAKEFLAGS 
always contains the current input options. This proves very useful for "super- 
makes". In fact, as noted above, when the -n option is used, the command $(MAKE) 
is executed anyway; hence, one can perform a make -n recursively on a whole 
software system to see what would have been executed. This is because the -n is put 
in MAKEFLAGS and passed to further invocations of $(MAKE). This is one way of 
debugging all of the makefiles for a software project without actually doing any- 
thing. 

If the string include appears as the first seven letters of a line in a makefile, and is fol- 
lowed by a blank or a tab, the rest of the line is assumed to be a file name and will be 
read by the current invocation, after substituting for any macros. 

Entries of the form stringl = string! are macro definitions. String! is defined as all 
characters up to a comment character or an unescaped new-line. Subsequent appear- 
ances of $(stringl[:substl=[subst!]]) are replaced by string!. The parentheses are 
optional if a single character macro name is used and there is no substitute sequence. 
The optional :substl=subst! is a substitute sequence. If it is specified, all non- 
overlapping occurrences of substl in the named macro are replaced by subst!. 
Strings (for the purposes of this type of substitution) are delimited by blanks, tabs, 
new-line characters, and beginnings of lines. An example of the use of the substitute 
sequence is shown under Libraries . 

There are five internally maintained macros which are useful for writing rules for 
building targets. 

$* The macro $* stands for the file name part of the current dependent with the 
suffix deleted. It is evaluated only for inference rules. 

$@ The $@ macro stands for the full target name of the current target. It is 
evaluated only for explicitly named dependencies. 

$< The $< macro is only evaluated for inference rules or the .DEFAULT rule. It is 
the module which is out-of-date with respect to the target (i.e., the "manufac- 
tured" dependent file name). Thus, in the .co rule, the $< macro would evalu- 
ate to the .c file. An example for making optimized .o files from .c files is: 



.co: 



cc -c -O $*.c 



( 



c 



or: 



.co: 



cc -c -O $< 



$? The $? macro is evaluated when explicit rules from the makefile are evaluated. 
It is the list of prerequisites that are out-of-date with respect to the target; essen- 
tially, those modules which must be rebuilt. 

$% The $% macro is only evaluated when the target is an archive library member 
of the form lib(file.o). In this case, $@ evaluates to lib and $% evaluates to the 
library member, file.o. 

Four of the five macros can have alternative forms. When an upper case D or F is 
appended to any of the four macros, the meaning is changed to "directory part" for 
D and "file part" for F. Thus, $(@D) refers to the directory part of the string $@. If 
there is no directory part, ./ is generated. The only macro excluded from this alterna- 
tive form is $?. 
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Certain names (for instance, those ending with .o) have inferable prerequisites such 
as x, .s, etc. If no update commands for such a file appear in makefile, and if an infer- 
able prerequisite exists, that prerequisite is compiled to make the target. In this case, 
make has inference rules which allow building files from other files by examining the 
suffixes and determining an appropriate inference rule to use. The current default 
inference rules are: 

.c .c~ .f i~ .sh .sh~ 

.c.o .c.a .c~.o .c~.c .c~.a 

.f.o i.a .f~.o i~.f i~.a 

.h~.h .s.o .s~.o .s~.s .s~.a .sh~.sh 

.l.o .l.c .Ko .l~.l .l~.c 

.y.o .y.c .y~.o .y~.y .y~.c 

The internal rules for make are contained in the source file rules.c for the make pro- 
gram. These rules can be locally modified. To print out the rules compiled into the 
make on any machine in a form suitable for recompilation, the following command is 
used: 

make -fp - 2>/dev/null </dev/null 

A tilde in the above rules refers to an SCCS file [see sccsfile(4)]. Thus, the rule .c~.o 
would transform an SCCS C source file into an object file (.o). Because the s. of the 
SCCS files is a prefix, it is incompatible with make's suffix point of view. Hence, the 
tilde is a way of changing any file reference into an SCCS file reference. 

A rule with only one suffix (i.e., .c:) is the definition of how to build x from x.c. In 
effect, the other suffix is null. This is useful for building targets from only one source 
file (e.g., shell procedures, simple C programs). 

Additional suffixes are given as the dependency list for .SUFFIXES. Order is 
significant; the first possible name for which both a file and a rule exist is inferred as 
a prerequisite. The default list is: 

.SUFFIXES: .o .c .c~ .y .y~ .1 .1- .s .s~ .sh .sh- .h .h~ .f i~ 



Here again, the above command for printing the internal rules will display the list of 
suffixes implemented on the current machine. Multiple suffix lists accumulate; .SUF- 
FIXES: with no dependencies clears the list of suffixes. 

The first example can be done more briefly. 

pgm: a.o b.o 

cc a.o b.o -o pgm 
a.o b.o: incl.h 

This is because make has a set of internal rules for building files. The user may add 
rules to this list by simply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the inclusion of 
optional matter in any resulting commands. For example, CFLAGS, LFLAGS, and 
YFLAGS are used for compiler options to cc(l), lex (I), and yacc(l), respectively. 
Again, the previous method for examining the current rules is recommended. 

The inference of prerequisites can be controlled. The rule to create a file with suffix 
.o from a file with suffix .c is specified as an entry with .c.o: as the target and no 
dependents. Shell commands associated with the target define the rule for making a 
.o file from a .c file. Any target that has no slashes in it and starts with a dot is 
identified as a rule and not a true target. 
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If a target or dependency name contains parentheses, it is assumed to be an archive 
library, the string within parentheses referring to a member within the library. Thus 
lib(file.o) and $(LIB)(file.o) both refer to an archive library which contains file.o. 
(This assumes the LIB macro has been previously defined.) The expression 
$(LIB)(filel.o file2.o) is not legal. Rules pertaining to archive libraries have the form 
.XX.a where the XX is the suffix from which the archive member is to be made. An 
unfortunate byproduct of the current implementation requires the XX to be different 
from the suffix of the archive member. Thus, one cannot have lib(file.o) depend 
upon file.o explicitly. The most common use of the archive interface follows. Here, 
we assume the source files are all C type source: 

lib: 



.c.a: 



lib(filel.o) lib(file2.o) lib(file3.o) 
©echo lib is now up-to-date 

$(CC) -c $(CFLAGS) $< 
$(AR) $(ARFLAGS) $@ $*.o 
rm-f$*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in this example. 
A more interesting, but more limited example of an archive library maintenance con- 
struction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 
$(CC) -c $(CFLAGS) $(?:.o=.c) 
$(AR) $(ARFLAGS) lib $? 
rm $? ©echo lib is now up-to-date 
.c.a:; 

Here the substitution mode of the macro expansions is used. The $? list is defined to 
be the set of object file names (inside lib) whose C source files are out-of-date. The 
substitution mode translates the .o to .c. (Unfortunately, one cannot as yet transform 
to .c~; however, this may become possible in the future.) Note also, the disabling of 
the .c.a: rule, which would have created each object file, one by one. This particular 
construct speeds up archive library maintenance considerably. This type of construct 
becomes very cumbersome if the archive library contains a mix of assembly pro- 
grams and C programs. 

[Mm]akefile and s.[Mm]akefile 
/bin/sh 

cc(l), cd(l), lex(l), sh(l), yacc(l), printf(3S), sccsfile(4). 

Some commands return non-zero status inappropriately; use -i to overcome the 
difficulty. 

File names with the characters = : @ will not work. 

Commands that are directly executed by the shell, notably cd(l), are ineffectual 

across new-lines in make. 

The syntax (lib(filel.o file2.o fileS.o) is illegal. You cannot build lib (file.o) from 

file.o. 

The macro $(a:.o=.c~) does not work. 

Named pipes are not handled well. 
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makekey - generate encryption key 

/usr/lib/makekey 

makekey improves the usefulness of encryption schemes depending on a key by 
increasing the amount of time required to search the key space. It reads 10 bytes 
from its standard input, and writes 13 bytes on its standard output. The output 
depends on the input in a way intended to be difficult to compute (i.e., to require a 
substantial fraction of a second). 

The first eight input bytes (the input key) can be arbitrary ASCII characters. The last 
two (the salt) are best chosen from the set of digits, ., /, and upper- and lower-case 
letters. The salt characters are repeated as the first two characters of the output. The 
remaining 11 output characters are chosen from the same set as the salt and consti- 
tute the output key. 

The transformation performed is essentially the following: the salt is used to select 
one of 4,096 cryptographic machines all based on the National Bureau of Standards 
DES algorithm, but broken in 4,096 different ways. Using the input key as key, a con- 
stant string is fed into the machine and recirculated a number of times. The 64 bits 
that come out are distributed into the 66 output key bits in the result. 

makekey is intended for programs that perform encryption. Usually, its input and 
output will be pipes. 

ed(l), crypt(l), vi(l), passwd(4). 

This command is provided with the Security Administration Utilities, which is only 
available in the United States. 
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man - find manual information by keywords; print out the manual 

man [ - ] [ -M path ] [ bsd ] [ section ] title ... 
man -k keyword ... 
man -f file ... 

man is a program which gives information from the programmers manual. It can be 
asked for one line descriptions of commands specified by name, or for all commands 
whose description contains any of a set of keywords. It can also provide on-line 
access to the sections of the printed manual. 

When given the option -k and a set of keywords, man prints out a one-line synopsis 
of each manual sections whose listing in the table of contents contains one of those 
keywords. 

When given the option -f and a list of file names, man attempts to locate manual sec- 
tions related to those files, printing out the table of contents lines for those sections. 

When neither -k nor -f is specified, man formats a specified set of manual pages. If a 
section specifier is given man looks in the that section of the manual for the given 
titles. Section is either an Arabic section number (3 for instance), or one of the words 
"new," "local," "old," or "public." A section number may be followed by a single 
letter classifier (for instance, lm, indicating an administration program in section 1). 
If section is omitted, man searches all sections of the manual, giving preference to 
commands over subroutines in system libraries, and printing the first section it finds, 
if any. 

When given the option bsd, man looks only for man pages related to commands and 
subroutines from the 4.3 BSD distribution. 

If the standard output is a teletype, or if the flag - is given, man pipes its output 
through moreiX) with the option -s to crush out useless blank lines and to stop after 
each page on the screen. Hit a space to continue, a control-D to scroll 11 more lines 
when the output stops. 

Normally man checks in a standard location for manual information (/usr/man). 
This can be changed by supplying a search path (a la the shell) with the -M flag. The 
search path is a colon (':') separated list of directories in which manual subdirectories 
may be found; e.g. "/usr/local:/usr/man". 

If the environment variable 'MANPATH' is set, its value is used for the default path. 
If a search path is supplied with the -k or -f options, it must be specified first. 

/usr/man standard manual area 

/usr/man/cat?/ * directories containing preformatted pages 

/usr/man/whatis keyword database 

/usr/man/cat?/Index index of entries and filenames 

/usr/man/bsd/cat?/* standard manual area for bsd pages 

apropos(l), more(l), man(5), catman(8) 
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mesg - permit or deny messages 

mesg [ -n ] [ -y ] 

mesg with argument n forbids messages via write(l) by revoking non-user write per- 
mission on the user's terminal, mesg with argument y reinstates permission. All by 
itself, mesg reports the current state without changing it. 

/dev/tty* 

write(l). 

Exit status is if messages are receivable, 1 if not, 2 on error. 
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mkdir - make directories 

mkdir [ -m mode ] [ -p] dirname ... 

mkdir creates the named directories in mode 777 (possibly altered by umask{\)\ 

Standard entries in a directory (e.g., the files ., for the directory itself, and .., for its 
parent) are made automatically, tnkdir cannot create these entries by name. Creation 
of a directory requires write permission in the parent directory. 

The owner ID and group ID of the new directories are set to the process's real user ID 
and group ID, respectively. 

Two options apply to mkdir : 

-m This option allows users to specify the mode to be used for new directories. 
Choices for modes can be found in chmod(l). 

-p With this option, mkdir creates dirname by creating all the non-existing parent 
directories first. 

To create the subdirectory structure ltr/jd/jan, type: 
mkdir -p ltr/jd/jan 

sh(l), rm(l), umask(l), intro(2), mkdir(2). 

mkdir returns exit code if all directories given in the command line were made suc- 
cessfully. Otherwise, it prints a diagnostic and returns non-zero. An error code is 
stored in errno . 
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mkfarm - configure a striped file system 

/etc/mkf arm [-m [-y]] farm_number special special ... 

Mkfarm configures a striped file system by associating all the specials into 1 logical file 
system known as /dev/farrn/farm{farm_number}. 

The -m option allows an mkfs to be done to the logical disk farm at the same time. 
The -m option always makes an Ardent Fast File System. If the -m option is used, the 
user is prompted for a yes/no answer before mkfarm proceeds to do the mkfs on the 
striped file system. The -y option suppresses the prompt and silently proceeds with 
the mkfs. 

mkfarm requires that all the disk partitions named have the same parameters (bytes 
per sector, sectors per track, tracks per cylinder), and that they are the same size. 
Mkfarm will use the entire partitions named on the command line. 

dfconf(lM), dflist(lM), dfreset(lM), mkfs(lM) 
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mkf s - construct a file system 

/etc/mkf s special blocks[:i-nodes] [gap blocks/cyl] 
/etc/mkf s special proto [gap blocks/cyl] 
/etc/mkf s [ -t type ] filsys proto [ gap blocks/cyl ] 
/etc/mkf s [ -t type ] filsys blocks[ :inodes ] [ gap blocks/cyl ] 

mkfs constructs a file system by writing on the special file using the values found in 
the remaining arguments of the command line. Invoking mkfs with only the -t 
option lists the types of file systems mkfs knows how to create. Names listed on the 
same line are synonyms; the first type listed is the default type. Invoking mkfs with 
-t and a file system type gives the command syntax for the file system type. 

4K FsTYPE4 DanaSV Sys5-4K 

AFFS affs FFS ffs DANA Dana 

If the second argument is a string of digits, the size of the file system is the value of 
blocks interpreted as a decimal number. This is the number of 512-byte sectors the file 
system will occupy. If the number of i-nodes is not given, the default is the number 
of logical (512, 1024, or 4096 byte) blocks divided by 4. mkfs builds a file system with 
a single empty directory on it. The boot program block (block zero) is left uninitial- 
ized. 

If the second argument is the name of a file that can be opened, mkfs assumes it to be 
a prototype file proto, and will take its directions from that file. The prototype file 
contains tokens separated by spaces or new-lines. A sample prototype specification 
follows (line numbers have been added to aid in the explanation): 



1. 


1 'stand/ 'diskboot 




2. 


4872 110 




3. 


d— 77731 




4. 


usr d— 777 3 1 




5. 


sh 


755 3 1 /bin/sh 


6. 


ken 


d— 755 6 1 


7. 




$ 


8. 


bO 


b— 644 310 


9. 


cO 


c— 644 310 


10. 


$ 




11. 


$ 





Line 1 in the example is the name of a file to be copied onto block zero as the 
bootstrap program. 

Line 2 specifies the number of 512-byte sectors the file system is to occupy and the 
number of i-nodes in the file system. 

Lines 3-9 tell mkfs about files and directories to be included in this file system. 

Line 3 specifies the root directory. 

lines 4-6 and 8-9 specifies other directories and files. 

The $ on line 7 tells mkfs to end the branch of the file system it is on, and continue 
from the next higher directory. The $ on lines 10 and 11 end the process, since no 
additional specifications follow. 

File specifications give the mode, the user ID, the group ID, and the initial contents of 
the file. Valid syntax for the contents field depends on the first character of the 
mode. 



( 



( 



( 



294 



Stardent 1500/3000 



MKFS(1M) 



Essential Utilities 



MKFS(1M) 



SEE ALSO 



BUGS 



The mode for a file is specified by a 6-character string. The first character specifies 
the type of the file. The character range is -bed to specify regular, block special, char- 
acter special and directory files respectively. The second character of the mode is 
either u or - to specify set-user-id mode or not. The third is g or - for the set-group- 
id mode. The rest of the mode is a 3 digit octal number giving the owner/group, and 
other read, write, execute permissions (see chmodd)). 

Two decimal number tokens come after the mode; they specify the user and group 
IDs of the owner of the file. 

If the file is a regular file, the next token of the specification may be a path name to 
which the contents and size are copied. If the file is a block or character special file, 
two decimal numbers follow which give the major and minor device numbers. If the 
file is a directory, mkfs makes the entries . and .. and then reads a list of names and 
(recursively) file specifications for the entries in the directory. As noted above, the 
scan is terminated with the token $. 

chmod(l), dir(4), dvhtool(lM), fs(4) 
Installation/ Administration Manual 

There is no way to specify links. The maximum number of i-nodes configurable is 
65500. 
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NAME 

SYNOPSIS 

DESCRIPTION 



devps 

MKLIST (1 PS) 



rnklist - PostScript label generator 

mklist [ -pos ] file(s) 

rnklist writes multiple labels on the default PostScript device using LW(IFS). It is gen- 
erally used to produce labels for bulk mailings. (Note: mklist requests manual feed 
and will print as many sheets of labels as necessary to list all the names in file(s).) 

The addresses in file(s) should have the following format: 

name 1 
addr 1-1 
addr 1-2 



C 



%EON% 
name 2 
addr 2-1 
addr 2-2 

%EON% 



EXAMPLE 



Addresses shouldn't be longer than five lines, as small (one inch high) labels can't fit much 
more. 

The following option is understood: 

-pos pos (an integer number) determines the first label that is written (say the 

first sheet is only partially used). See mkenv(lPS) for information on the 
label numbering scheme. 

Print labels for the addresses in mail . list starting on label #10: 

$ mklist -10 mail. list 



( 



FILES 
SEE ALSO 

WARNING 



/usr/lib/laser/maillist PostScript prolog for labels 

LW(lPS),mkenv(lPS) 
Devps User's Guide 

mklist will print as many address lines on the envelope or label as you give it. Speci- 
fying too many lines, particularly on small labels, will cause the address to "spill 
over" onto the next label. 



( 
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NAME 



mknod - build special file 



SYNOPSIS 



/etc/mknod name b I c major minor 
/etc/mknod name p 

DESCRIPTION 

mknod makes a directory entry and corresponding i-node for a special file. 

The first argument is the name of the entry. The UNIX convention is to keep such files 
in the /dev directory. 

In the first case, the second argument is b if the special file is block-type (disks, tape) 
or c if it is character-type (other devices). The last two arguments are numbers speci- 
fying the major device type and the minor device (e.g., unit, drive, or line number). 
They may be either decimal or octal. The assignment of major device numbers is 
specific to each system. The information is contained in the system source file 
master.c. You must be the super-user to use this form of the command. 

The second case is the form of the mknod that is used to create FIFO's (a.k.a named 
pipes). 

SEE ALSO 

mknod(2) 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



MKSTR(1) 



mkstr - create an error message file by massaging C source 

mkstr [ - ] messagefile prefix file ... 

mkstr is used to create files of error messages. Its use can make programs with large 
numbers of error diagnostics much smaller, and reduce system overhead in running 
the program as the error messages do not have to be constantly swapped in and out. 

mkstr will process each of the specified files, placing a massaged version of the input 
file in a file whose name consists of the specified prefix and the original name. A typi- 
cal usage of mkstr would be 

mkstr pistrings xx *.c 

This command would cause all the error messages from the C source files in the 
current directory to be placed in the file pistrings and processed copies of the source 
for these files to be placed in files whose names are prefixed with xx. 

To process the error messages in the source to the message file mkstr keys on the 
string 'error( n/ in the input stream. Each time it occurs, the C string starting at the "" 
is placed in the message file followed by a null character and a new-line character; 
the null character terminates the message so it can be easily used when retrieved, the 
new-line character makes it possible to sensibly cat the error message file to see its 
contents. The massaged copy of the input file then contains a Iseek pointer into the 
file which can be used to retrieve the message, i.e.: 

char efilnamel] = Vusr/lib/pLstrings"; 
int efil = -1; 

error(al, a2, a3, a4) 

{ 

charbuf[256]; 

if (efil < 0) { 

efil = open(efilname, 0); 
if (efil < 0) { 



oops: 



perror(efilname); 
exit(l); 



} 



} 



} 

if (lseek(efil, (long) al, 0) I I read(efil, buf, 256) <= 0) 

goto oops; 
printf(buf, a2, a3, a4); 



The optional - causes the error messages to be placed at the end of the specified mes- 
sage file for recompiling part of a large mkstr ed program. 

lseek(2),xstr(l) 



c 



( 
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NAME 



more, page - file perusal filter for crt viewing 



SYNOPSIS 



more [ -cdflsu ] [ -n ] [ +linenumber ] [ +/pattern ] [ name ... ] 
page more options 

DESCRIPTION 

more is a filter which allows examination of a continuous text one screenful at a time 
on a soft-copy terminal. It normally pauses after each screenful, printing -More— at 
the bottom of the screen. If the user then types a carriage return, one more line is 
displayed. If the user hits a space, another screenful is displayed. Other possibilities 
are enumerated later. 

The command line options are: 

-n An integer which is the size (in lines) of the window which more will use 
instead of the default. 

-c more will draw each page by beginning at the top of the screen and erasing each 
line just before it draws on it. This avoids scrolling the screen, making it easier 
to read while more is writing. This option will be ignored if the terminal does 
not have the ability to clear to the end of a line. 

-d more will prompt the user with the message "Press space to continue, 'q' to 
quit." at the end of each screenful, and will respond to subsequent illegal user 
input by printing "Press 'h' for instructions." instead of ringing the bell. This is 
useful if more is being used as a filter in some setting, such as a class, where 
many users may be unsophisticated. 

-f This causes more to count logical, rather than screen lines. That is, long lines are 
not folded. This option is recommended if nroff output is being piped through 
ul, since the latter may generate escape sequences. These escape sequences con- 
tain characters which would ordinarily occupy screen positions, but which do 
not print when they are sent to the terminal as part of an escape sequence. 
Thus more may think that lines are longer than they actually are, and fold lines 
erroneously. 

-1 Do not treat A L (form feed) specially. If this option is not given, more will pause 
after any line that contains a A L, as if the end of a screenful had been reached. 
Also, if a file begins with a form feed, the screen will be cleared before the file is 
printed. 

-s Squeeze multiple blank lines from the output, producing only one blank line. 
Especially helpful when viewing nroff output, this option maximizes the useful 
information present on the screen. 

-u Normally, more will handle underlining such as produced by nroff in a manner 
appropriate to the particular terminal: if the terminal can perform underlining 
or has a stand-out mode, more will output appropriate escape sequences to 
enable underlining or stand-out mode for underlined information in the source 
file. The -u option suppresses this processing. 

+linenumber 

Start up at linenumber. 

+lpattern 

Start up two lines before the line containing the regular expression pattern. 
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If the program is invoked as page, then the screen is cleared before each screenful is 
printed (but only if a full screenful is being printed), and k - 1 rather than k - 2 lines 
are printed in each screenful, where k is the number of lines the terminal can display. 

more looks in the file /etc/termcap to determine terminal characteristics, and to deter- 
mine the default window size. On a terminal capable of displaying 24 lines, the 
default window size is 22 lines. 

more looks in the environment variable MORE to pre-set any flags desired. For 
example, if you prefer to view files using the -c mode of operation, the csh command 
setenv MORE -c or the sh command sequence MORE-'-c r ; export MORE would cause 
all invocations of more , including invocations by programs such as man and msgs , to 
use this mode. Normally, the user will place the command sequence which sets up 
the MORE environment variable in the .cshrc or .profile file. 

If more is reading from a file, rather than a pipe, then a percentage is displayed along 
with the --More- prompt. This gives the fraction of the file (in characters, not lines) 
that has been read so far. 

Other sequences which may be typed when more pauses, and their effects, are as fol- 
lows (i is an optional integer argument, defaulting to 1) : 

f<space> 

display i more lines, (or another screenful if no argument is given) 

display 11 more lines (a "scroll" ). If i is given, then the scroll size is set to i . 

same as A D (control-D) 

same as typing a space except that i, if present, becomes the new window size. 

skip i lines and print a screenful of lines 

skip i screenfuls and print a screenful of lines 

skip back i screenfuls and print a screenful of lines 

i A B same as b 



d 

iz 
s 
f 
b 



qorQ 

Exit from more. 

= Display the current line number. 

v Start up the editor vi at the current line. 

h Help command; give a description of all the more commands. 

f/expr 

search for the i-th occurrence of the regular expression expr. If there are less 
than i occurrences of expr, and the input is a file (rather than a pipe), then the 
position in the file remains unchanged. Otherwise, a screenful is displayed, 
starting two lines before the place where the expression was found. The user's 
erase and kill characters may be used to edit the regular expression. Erasing 
back past the first column cancels the search command. 

i n search for the i -th occurrence of the last regular expression entered. 

(single quote) Go to the point from which the last search started. If no search 
has been performed in the current file, this command goes back to the begin- 
ning of the file. 

Icommand 

invoke a shell with command. The characters '%' and '!' in "command" are 
replaced with the current file name and the previous shell command respec- 
tively. If there is no current file name, '%' is not expanded. The sequences 



( 



( 
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FILES 

SEE ALSO 
BUGS 



"\%" and "\!" are replaced by "%" and "!" respectively. 

i :n skip to the i -th next file given in the command line (skips to last file if n doesn't 
make sense) 

z:p skip to the z-th previous file given in the command line. If this command is 
given in the middle of printing out a file, then more goes back to the beginning 
of the file. If i doesn't make sense, more skips back to the first file. If more is not 
reading from a file, the bell is rung and nothing else happens. 

:f display the current file name and line number. 

:q or :Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not necessary to type a carriage 
return. Up to the time when the command character itself is given, the user may hit 
the line kill character to cancel the numerical argument being formed. In addition, 
the user may hit the erase character to redisplay the ~More~(xx%) message. 

At any time when output is being sent to the terminal, the user can hit the quit key 
(normally control-\). more will stop sending output, and will display the usual - 
More- prompt. The user may then enter one of the above commands in the normal 
manner. Unfortunately, some output is lost when this is done, due to the fact that 
any characters waiting in the terminal's output queue are flushed when the quit sig- 
nal occurs. 

The terminal is set to noecho mode by this program so that the output can be continu- 
ous. What you type will thus not show on your terminal, except for the / and ! com- 
mands. 

If the standard output is not a teletype, then more acts just like cat, except that a 
header is printed before each file (if there is more than one). 

A sample usage of more in previewing nroff output would be 

nroff -ms +2 doc.n I more -s 

/etc/termcap Terminal data base 

/usr/lib/more.help Help file 

csh(l), man(l), msgs(l), script(l), sh(l), environ(7) 

Skipping backwards is too slow on large files. 
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NAME 
SYNOPSIS 

DESCRIPTION 



M0UNT(1M) 



mount, umount - mount and unmount file systems and remote resources 

/etc/mount [[-r] [-f fstyp] special directory] 
/etc/mount [[-r] [-f NFS [ option ] ] resource directory] 
/etc/umount special 

File systems other than root ( / ) are considered removable in the sense that they can be 
either available to users or unavailable, mount announces to the system that special, 
a block special device or resource, a remote resource, is available to users from the 
mount point directory, directory must exist already; it becomes the name of the root of 
the newly mounted special 

mount, when entered with arguments, adds an entry to the table of mounted devices, 
/etc/mnttab. umount removes the entry. If invoked with no arguments, mount 
prints the entire mount table. If invoked with an incomplete argument list, mount 
searches /etc/f stab for the missing arguments. 

The following options are available: 

-r indicates that special or resource is to be mounted read-only. If special or 

resource is write-protected, this flag must be used. 

-f NFS indicates that an NFS file system is to be mounted. NFS options may be 
added after NFS separated by commas. The available NFS options are: 

soft return error if the server doesn't respond. 

rsize=n 

set the read buffer size to n bytes. 

wsize=n 

set the write buffer size to n bytes 

timeo=n 

set the initial NFS timeout to n tenths of a second 

retrans=n 

set the number of NFS retransmissions to n 

port=n 

set the server IP port number to n 

special indicates the block special device that is to be mounted on directory. If the 
file system type is NFS, then special should be of the form 
hostname: /pathname. 

resource indicates the remote resource name that is to be mounted on a directory. 
If the file system type is NFS, then mount attempts to translate resource 
into a special of the form hostname: /pathname, and then proceeds as if a spe- 
cial were originally specified. 

directory indicates the directory mount point for special or resource. (The directory 
must already exist.) 

umount announces to the system that the file system previously mounted special or 
resource is to be made unavailable. If invoked with an incomplete argument list, 
umount searches /etc/f stab for the missing arguments. 

mount can be used by any user to list mounted file systems and resources. Only a 
super-user can mount and unmount file systems. 
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DIAGNOSTICS 



M0UNT(1M) 



/etc/mnttab mount table 
/etc/fstab file system table 

fstab(4), fuser(lM), mnttab(4), mount(2), setmnt(lM), umount(2) 

If the mount(2) system call fails, mount prints an appropriate diagnostic, mount 
issues a warning if the file system to be mounted is currently mounted under another 
name. A remote resource mount will fail if the resource is not available. 

umount fails if special or resource is not mounted or if it is busy, special or resource is 
busy if it contains an open file or some user's working directory. In such a case, you 
can use fuser(lM) to list and kill processes that are using special or resource. 
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NAME 



SYNOPSIS 



DESCRIPTION 



FILES 



SEE ALSO 



DIAGNOSTICS 



MOUNTALL(IM) 



mountall, umountall - mount, unmount multiple file systems 

/etc/mountall [-] [file-system-table] ... 
/etc/umountall [ -k ] 

These commands may be executed only by the super-user. 

mountall is used to mount file systems according to a. file-system-table, (/etc/fstab is 
the default file system table.) The special file name "-" reads from the standard input. 

Before each file system is mounted, it is checked using fsstat(lM) to see if it appears 
mountable. If the file system does not appear mountable, it is checked, using 
/scfc(lM), before the mount is attempted. 

umountall causes all mounted file systems except root to be unmounted. The -k 
option sends a SIGKILL signal, via fuser(lM), to processes that have files open. 

File-system-table format: 

column 1 block special file name of file system 

column 2 mount-point directory 

column 3 "-r" if to be mounted read-only 

column 4 (optional) file system type string 

column 5+ ignored 

White-space separates columns. Lines beginning with "#" are comments. Empty 
lines are ignored. 

A typical file-system-table might read: 

/dev/dsk/cld0s2/usr -r S51K 

fsck(lM), fsstat(lM), fstab(4), fuser(lM), mount(lM), signal(2), sysadm(l). 

No messages are printed if the file systems are mountable and clean. 

Error and warning messages come from/scfc(lM),/ssta£(lM), and tnountdM). 
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SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 



MT(1) 



mt - magnetic tape manipulating program 
mt [ -f tapenarne ] command [ count ] 

Mt is used to give commands to a magnetic tape drive. If a tape name is not 
specified, the environment variable TAPE is used; if TAPE does not exist, mt uses the 
device /dev/rmtl2 . Note that tapenarne must reference a raw (not block) tape device. 
By default mt performs the requested operation once. Operations may be performed 
multiple times by specifying count. 

The available commands are listed below. Only as many characters as are required 
to uniquely identify a command need be specified. 

eof, weof 

Write count end-of-file marks at the current position on the tape. 

f sf Forward space count files. 

f sr Forward space count records. 

bsf Back space count files. 

bsr Back space count records. 

rewind 

Rewind the tape (Count is ignored). 

offline, rewof fl 

Rewind the tape and place the tape unit off-line (Count is ignored). 

status 

Print status information about the tape unit. 

Mt returns a exit status when the operation(s) were successful, 1 if the command 
was unrecognized, and 2 if an operation failed. 

/dev/rmt* Raw magnetic tape interface 

mtio(4), dd(l), ioctl(2), environ(7) 
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SYNOPSIS 

DESCRIPTION 



System Administration Utilities 



SEE ALSO 
WARNINGS 



MVD1R(1M) 



mvdir - move a directory 

/etc/mvdir dirname name 

mvdir moves directories within a file system. Dirname must be a directory. If name 
does not exist, it will be created as a directory. If name does exist, dirname will be 
created as name/dirname. Dirname and name may not be on the same path; that is, one 
may not be subordinate to the other. For example: 

mvdir x/y x/z 
is legal, but 

mvdir x/y x/y/z 
is not. 

mkdir(l), mv(l). 

Only the super-user can use mvdir . 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



ncheck - generate path names from i-numbers 

/etc/ncheck [ -i i-numbers ] [ -a ] [ -s ] [ file-system ] 

ncheck with no arguments generates a path-name vs. i-number list of all files on a set 
of default file systems (see /etc/checklist). Names of directory files are followed by /. 

The options are as follows: 

-i limits the report to only those files whose i-numbers follow. 

-a allows printing of the names . and .., which are ordinarily suppressed. 

-s limits the report to special files and files with set-user-ID mode. This option 
may be used to detect violations of security policy. 

File system must be specified by the file system's special file. 

The report should be sorted so that it is more useful. 

fsck(lM), sort(l). 

If the file system structure is not consistent, ?? denotes the "parent" of a parentless 
file and a path-name beginning with ... denotes a loop. 



Stardent 1500/3000 



307 



Networking Utilities 



NDA(1M) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 



NDA(1M) 



nda - network daemon 

nda [-d] [-f confile] 

nda is the master network daemon and is usually started by rc2(lM). Currently, nda 
will open and link the following devices: ethernet, arp, ip, tcp, udp, and raw ip. 

The driver information is specified in the default file /etc/nda.conf. The default can be 
changed with the -f option. Each line in the configuration file indicates the presence 
of a "stream." For example, the following line indicates that there exists a stream 
between the ip (mux) driver and the et driver. 

et ip 

The -d option provides debugging information. 

This command is restricted to the super-user. 



( 



/etc/nda.conf 



rc2(lM), uname(2) 



driver configuration 
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netstat - show network status 

nets tat [ -Aan ] [ -f address Jamily ] [ system ] [ core ] 
netstat [ -himnrs ] [ -f address Jamily ] [ system ] [ core ] 
netstat [ -n ] [ -I interface ] interval [ system ] [ core ] 

The netstat command symbolically displays the contents of various network-related 
data structures. There are a number of output formats, depending on the options for 
the information presented. The first form of the command displays a list of active 
sockets for each protocol. The second form presents the contents of one of the other 
network data structures according to the option selected. Using the third form, with 
an interval specified, netstat will continuously display the information regarding 
packet traffic on the configured network interfaces. 

The options have the following meaning: 

-A With the default display, show the address of any protocol control blocks asso- 
ciated with sockets; used for debugging. 

With the default display, show the state of all sockets; normally sockets used by 
server processes are not shown. 

Show the state of the IMP host table. 

Show the state of interfaces which have been auto-configured (interfaces stati- 
cally configured into a system, but not located at boot time are not shown). 

•I interface 

Show information only about this interface; used with an interval as described 
below. 

Show statistics recorded by the memory management routines (the network 
manages a private pool of memory buffers). 

Show network addresses as numbers (normally netstat interprets addresses and 
attempts to display them symbolically). This option may be used with any of 
the display formats. 

Show per-protocol statistics. 

Show the routing tables. When -s is also present, show routing statistics 
instead. 



-a 



-l 



-m 



-n 



-s 



-r 



-f address Jamily 

Limit statistics or address control block reports to those of the specified 
address family . The following address families are recognized: inet, for 
AFJNET, ns, for AF_NS, and unix, for AFJJNIX. 

The arguments, system and core allow substitutes for the defaults "/unix" and 
"/dev/kmem". 

The default display, for active sockets, shows the local and remote addresses, send 
and receive queue sizes (in bytes), protocol, and the internal state of the protocol. 
Address formats are of the form "host.port" or "network.port" if a socket's address 
specifies a network but no specific host address. When known the host and network 
addresses are displayed symbolically according to the data bases /etc/hosts and 
/etc/networks, respectively. If a symbolic name for an address is unknown, or if the -n 
option is specified, the address is printed numerically, according to the address fam- 
ily. For more information regarding the Internet "dot format," refer to inet(3N). 
Unspecified, or "wildcard", addresses and ports appear as "*". 
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The interface display provides a table of cumulative statistics regarding packets 
transferred, errors, and collisions. The network addresses of the interface and the 
maximum transmission unit ("mtu") are also displayed. 

The routing table display indicates the available routes and their status. Each route 
consists of a destination host or network and a gateway to use in forwarding packets. 
The flags field shows the state of the route ("U" if "up"), whether the route is to a 
gateway ("G"), and whether the route was created dynamically by a redirect ("D"). 
Direct routes are created for each interface attached to the local host; the gateway 
field for such entries shows the address of the outgoing interface. The refcnt field 
gives the current number of active uses of the route. Connection oriented protocols 
normally hold on to a single route for the duration of a connection while connection- 
less protocols obtain a route while sending to the same destination. The use field 
provides a count of the number of packets sent using that route. The interface entry 
indicates the network interface utilized for the route. 

When netstat is invoked with an interval argument, it displays a running count of 
statistics related to network interfaces. This display consists of a column for the pri- 
mary interface (the first interface found during autoconfiguration) and a column 
summarizing information for all interfaces. The primary interface may be replaced 
with another interface with the -I option. The first line of each screen of information 
contains a summary since the system was last rebooted. Subsequent lines of output 
show values accumulated over the preceding interval. 

hosts(5), networks(5), protocols(S), services(5) 

The notion of errors is ill-defined. Collisions mean something else for the IMP. 
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NEWFORM(1 ) NEWFORM (1 ) 

NAME 

newform - change the format of a text file 

newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] [-cchar] [-In] 
[files] 

newform reads lines from the named files, or the standard input if no input file is 
named, and reproduces the lines on the standard output. Lines are reformatted in 
accordance with command line options in effect. 

Except for -s, command line options may appear in any order, may be repeated, and 
may be intermingled with the optional files . Command line options are processed in 
the order specified. This means that option sequences like "-el5 -160" will yield 
results different from ' -160 -el5". Options are applied to all files on the command 
line. 

-s Shears off leading characters on each line up to the first tab and places up 

to 8 of the sheared characters at the end of the line. If more than 8 charac- 
ters (not counting the first tab) are sheared, the eighth character is 
replaced by a * and any characters to the right of it are discarded. The 
first tab is always discarded. 

An error message and program exit will occur if this option is used on a 
file without a tab on each line. The characters sheared off are saved inter- 
nally until all other options specified are applied to that line. The charac- 
ters are then added at the end of the processed line. 

For example, to convert a file with leading digits, one or more tabs, and 
text on each line, to a file beginning with the text, all tabs after the first 
expanded to spaces, padded with spaces out to column 72 (or truncated to 
column 72), and the leading digits placed starting at column 73, the com- 
mand would be: 
newform -s -i -1 -a -e file-name 

-itabspec Input tab specification: expands tabs to spaces, according to the tab 
specifications given. Tabspec recognizes all tab specification forms 
described in tabs{\). In addition, tabspec may be — , in which newform 
assumes that the tab specification is to be found in the first line read from 
the standard input (see fspec(4d). If no tabspec is given, tabspec defaults to 
-8. A tabspec of -0 expects no tabs; if any are found, they are treated as -1. 

-otabspec Output tab specification: replaces spaces by tabs, according to the tab 
specifications given. The tab specifications are the same as for -itabspec. 
If no tabspec is given, tabspec defaults to -8. A tabspec of -0 means that no 
spaces will be converted to tabs on output. 

-bn Truncate n characters from the beginning of the line when the line length 

is greater than the effective line length (see -In). Default is to truncate the 
number of characters necessary to obtain the effective line length. The 
default value is used when -b with no n is used. This option can be used 
to delete the sequence numbers from a COBOL program as follows: 
newform -11 -t>7 file-name 

-en Same as -bn except that characters are truncated from the end of the 
line. 

-pn Prefix n characters (see -ck) to the beginning of a line when the line 
length is less than the effective line length. Default is to prefix the 
number of characters necessary to obtain the effective line length. 
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DIAGNOSTICS 



SEE ALSO 
BUGS 



-an Same as -pn except characters are appended to the end of a line. 

-f Write the tab specification format line on the standard output before 
any other lines are output. The tab specification format line which 
is printed will correspond to the format specified in the last -o 
option. If no -o option is specified, the line which is printed will 
contain the default specification of -8. 

—cfc Change the prefix/append character to fc. Default character for k is 
a space. 

-In Set the effective line length to n characters. If n is not entered, -1 
defaults to 72. The default line length without the -1 option is 80 
characters. Note that tabs and backspaces are considered to be one 
character (use -i to expand tabs to spaces). 

The -11 must be used to set the effective line length shorter than any exist- 
ing line in the file so that the -b option is activated. 



All diagnostics are fatal. 
usage: ... 
not -s format 
can't open file 
internal line too long 

tabspec in error 

tahspec indirection illegal 

- normal execution 

1 - for any error 



newform was called with a bad option. 
There was no tab on one line. 
Self-explanatory. 

A line exceeds 512 characters after being expanded in the 
internal work buffer. 

A tab specification is incorrectly formatted, or specified tab 
stops are not ascending. 

A tabspec read from a file (or standard input) may not con- 
tain a tabspec referencing another file (or standard input). 



csplit(l), tabs(l), fspec(4). 

newform normally only keeps track of physical characters; however, for the -i and -o 
options, newform will keep track of backspaces in order to line up tabs in the 
appropriate logical columns. 

newform will not prompt the user if a tabspec is to be read from the standard input (by 
use of -i — or -o- -). 

If the -f option is used, and the last -o option specified was -o- — , and was preceded 
by either a -o — or a ~i — , the tab specification format line will be incorrect. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
BUGS 



NEWGRP(1M) 



newgrp - log in to a new group 

newgrp[-] [group] 

newgrp changes a user's group identification. The user remains logged in and the 
current directory is unchanged, but calculations of access permissions to files are per- 
formed with respect to the new real and effective group IDs. The user is always given 
a new shell, replacing the current shell, by newgrp, regardless of whether it ter- 
minated successfully or due to an error condition (i.e., unknown group). 

Exported variables retain their values after invoking newgrp; however, all unex- 
posed variables are either reset to their default value or set to null. System variables 
(such as PS1, PS2, PATH, MAIL, and HOME), unless exported by the system or 
explicitly exported by the user, are reset to default values. For example, a user has a 
primary prompt string (PS1) other than $ (default) and has not exported PS1. After 
an invocation of newgrp , successful or not, their PS1 will now be set to the default 
prompt string $. Note that the shell command export (see sh(D) is the method to 
export variables so that they retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification back to the group 
specified in the user's password file entry. This is a way to exit the effect of an earlier 
newgrp command. 

If the first argument to newgrp is a -, the environment is changed to what would be 
expected if the user actually logged in again as a member of the new group. 

A password is demanded if the group has a password and the user does not, or if the 
group has a password and the user is not listed in /etc/group as being a member of 
that group. 



/etc/group 
/etc/passwd 



system's group file 
system's password file 



environ(5), group(4), login(l), passwd(4), sh(l). 

There is no convenient way to enter a password into /etc/group. Use of group pass- 
words is not encouraged, because, by their very nature, they encourage poor security 
practices. Group passwords may disappear in the future. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



NEWS(1) 



news - print news items 

news [ -a ] [ -n ] [ -s ] [ items ] 

news is used to keep the user informed of current events. By convention, these 
events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all> current files in 
/usr/news, most recent first, with each preceded by an appropriate header, news 
stores the "currency" time as the modification date of a file named .news_time in the 
user's home directory (the identity of this directory is determined by the environ- 
ment variable $HOME); only files more recent than this currency time are considered 
"current." 

-a option causes news to print all items, regardless of currency. In this case, the 
stored time is not changed. 

-n option causes news to report the names of the current items without printing 
their contents, and without changing the stored time. 

-s option causes news to report how many current items exist, without printing 
their names or contents, and without changing the stored time. It is useful to 
include such an invocation of news in one's .profile file, or in the system's 
/etc/profile. 

All other arguments are assumed to be specific news items that are to be printed. 

If a delete is typed during the printing of a news item, printing stops and the next 
item is started. Another delete within one second of the first causes the program to 
terminate. 

/etc/ profile 
/usr/news/* 
$HOME/ .news_time 

profile(4), environ(5). 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



NICE(1) 

nice - run a command at low priority 

nice [ -increment ] command [ arguments ] 

nice executes command with a lower CPU scheduling priority. If the increment argu- 
ment (in the range 1-19) is given, it is used; if not, an increment of 10 is assumed. 

The super-user may run commands with priority higher than normal by using a 
negative increment, e.g., — 10. 

nohup(l), nice(2). 

nice returns the exit status of the subject command. 

An increment larger than 19 is equivalent to 19. 
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NAME 
SYNOPSIS 

DESCRIPTION 



NL(1) 



nl - line numbering filter 

nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] [-wwidth] 
[-nformat] [-ddelim] file 

nl reads lines from the named file or the standard input if no file is named and repro- 
duces the lines on the standard output. Lines are numbered on the left in accordance 
with the command options in effect. 

nl views the text it reads in terms of logical pages. Line numbering is reset at the 
start of each logical page. A logical page consists of a header, a body, and a footer 
section. Empty sections are valid. Different line numbering options are indepen- 
dently available for header, body, and footer (e.g., no numbering of header and 
footer lines while numbering blank lines only in the body). 

The start of logical page sections are signaled by input lines containing nothing but 
the following delimiter character(s): 

Line contents Start of 

\ : \ : \ : header 



\:\: 
\: 



body 
footer 



Unless optioned otherwise, nl assumes the text being read is in a single logical page 
body. 

Command options may appear in any order and may be intermingled with an 
optional file name. Only one file may be named. The options are: 

-htype Specifies which logical page body lines are to be numbered. Recognized 
types and their meaning are: 

-htype Same as -htype except for header. Default type for logical page header is 
n (no lines numbered). 

a number all lines 

t number lines with printable text only 

n no line numbering 

pstring number only lines that contain the regular expression 
specified in string. 

Default type for logical page body is t (text lines numbered). 

-(type Same as -htype except for footer. Default for logical page footer is n (no 
lines numbered). 

-vstartft Start# is the initial value used to number logical page lines. Default is 1. 

-iincr Incr is the increment value used to number logical page lines. Default is 
1. 

-p Do not restart numbering at logical page delimiters. 

-Inum Num is the number of blank lines to be considered as one. For example, 
-12 results in only the second adjacent blank being numbered (if the 
appropriate -ha, -ba, and/or -fa option is set). Default is 1. 
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EXAMPLE 



SEE ALSO 



-ssep Sep is the character(s) used in separating the line number and the 

corresponding text line. Default sep is a tab. 

-wwidth Width is the number of characters to be used for the line number. Default 
width is 6. 

-nformat Format is the line numbering format. Recognized values are: In, left 
justified, leading zeroes suppressed; rn, right justified, leading zeroes 
supressed; rz, right justified, leading zeroes kept. Default format is rn 
(right justified). 

-dxx The delimiter characters specifying the start of a logical page section may- 

be changed from the default characters (\ :) to two user-specified charac- 
ters. If only one character is entered, the second character remains the 
default character (:). No space should appear between the -d and the del- 
imiter characters. To enter a backslash, use two backslashes. 

The command: 

nl-vlO-ilO-d!+filel 

will number filel starting at line number 10 with an increment of ten. The logical 
page delimiters are !+. 

pr(l). 
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NAME 

SYNOPSIS 

DESCRIPTION 



NM(1) 



nm - print name list of common object file 

nm [-adehnoruxVT] filename ... 

The nm command displays the symbol table of each common object file, filename. 
Filename may be a relocatable or absolute common object file; or it may be an archive 
of relocatable or absolute common object files. For each symbol, the following infor- 
mation will be printed: 

Name The name of the symbol . 

Value Its value expressed as an offset or an address depending on its storage 
class. 

Class Its storage class. 

Type Its type and derived type. If the symbol is an instance of a structure or of a 
union then the structure or union tag will be given following the type (e.g., 
struct-tag). If the symbol is an array, then the array dimensions will be 
given following the type (e.g., chart n ][ m ] ). Note that the object file must 
have been compiled with the -g option of the cc(l) command for this infor- 
mation to appear. 

Size Its size in bytes, if available. Note that the object file must have been com- 

piled with the -g option of the cc(l) command for this information to 
appear. 

Section For storage classes static and external, the object file section containing the 
symbol (e.g., text, data or bss). 

The output of nm may be controlled using the following options: 

-a Print symbols in the order in which they appear in the symbol table. 

-d Print the value of a symbol in decimal rather than hexadecimal. 

-e Print only external and static symbols. 

-h Do not display the output header data. 

-n Sort symbols by name before they are printed. 

-o Print the value and size of a symbol in octal instead of decimal. 

-r Prepend the name of the object file or archive to each output line. 

-u Print undefined symbols only. 

-v Sort symbols by value before they are printed (default). 

-x Print the value of a symbol in hexadecimal (default). 

-V Print the version of the nm command executing on the standard error out- 

put. 

-T By default, nm prints the entire name of the symbols listed. Since object 

files can have symbols names with an arbitrary number of characters, a 
name that is longer than the width of the column set aside for names will 
overflow its column, forcing every column after the name to be misaligned. 
The -T option causes nm to truncate every name which would otherwise 
overflow its column and place an asterisk as the last character in the 
displayed name to mark it as truncated. 
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Options may be used in any order, either singly or in combination. 



SEE ALSO 

as(l), cc(l), ld(l), a.out(4), ar(4). 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLE 



SEE ALSO 
WARNINGS 



nohup - run a command immune to hangups and quits 

nohup command [ arguments ] 

nohup executes command with hangups and quits ignored. If output is not re- 
directed by the user, both standard output and standard error are sent to nohup.out. 
If nohup.out is not writable in the current directory, output is redirected to 
$HOME/nohup.out. 

This nohup is a built-in command in the csh. This man page applies to /bin/nohup. The 
C shell has a built-in nohup command that is different; see csh(l). 

It is frequently desirable to apply nohup to pipelines or lists of commands. This can 
be done only by placing pipelines and command lists in a single file, called a shell 
procedure. One can then issue: 

nohup sh file 

and the nohup applies to everything in file. If the shell procedure file is to be executed 
often, then the need to type sh can be eliminated by giving file execute permission. 
Add an ampersand and the contents of file are run in the background with interrupts 
also ignored (see sh(l)): 

nohup file & 

An example of what the contents of file could be is: 

sort ofile > nfile 

chmod(l), nice(l), sh(l), signal(2). 

In the case of the following command 

nohup commandl; command2 
nohup applies only to commandl. The command 

nohup (commandl; command2) 
is syntactically incorrect. 
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NAME 

nslookup - query name servers interactively 

nslookup [ host-to-find I - [ server address I server name ]] 

nslookup is a program to query DARPA Internet domain name servers, nslookup has 
two modes: interactive and non-interactive. Interactive mode allows the user to 
query the name server for information about various hosts and domains or print a 
list of hosts in the domain. Non-interactive mode is used to print just the name and 
Internet address of a host or domain. 

Interactive mode is entered in the following cases: 

a) when no arguments are given (the default name server will be used), and 

b) when the first argument is a hyphen (-) and the second argument is the host 
name of a name server. 

Non-interactive mode is used when the name of the host to be looked up is given as 
the first argument. The optional second argument specifies a name server. 

INTERACTIVE COMMANDS 

Commands may be interrupted at any time by typing a control-C. To exit, type a 
control-D (EOF). The command line length must be less than 80 characters. N.B. an 
unrecognized command will be interpreted as a host name. 

host [server] 

Look up information for host using the current default server or using server if it 
is specified. 

server domain 

Iserver domain 

Change the default server to domain. Lserver uses the initial server to look up 
information about domain while server uses the current default server. If an 
authoritative answer can't be found, the names of servers that might have the 
answer are returned. 

root Changes the default server to the server for the root of the domain name space. 
Currently, the host sri-nic.arpa is used. (This command is a synonym for the 
lserver sri-nic.arpa.) The name of the root server can be changed with the set 
root command. 

finger [name] [> filename] 

finger [name] [» filename] 

Connects with the finger server on the current host. The current host is defined 
when a previous lookup for a host was successful and returned address infor- 
mation (see the set querytype=A command). Name is optional. > and » can be 
used to redirect output in the usual manner. 
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Is domain [> filename] I 

Is domain [» filename] ^ 

Is -a domain [> filename] 
Is -a domain [» filename] 
Is -h domain [> filename] 
Is -h domain [» filename] 

Is -d domain [> filename] 

List the information available for domain. The default output contains host 
names and their Internet addresses. The -a option lists aliases of hosts in the 
domain. The -h option lists CPU and operating system information for the 
domain. The -d option lists all contents of a zone transfer. When output is 
directed to a file, hash marks are printed for every 50 records received from the 
server. 

view filename 

Sorts and lists the output of previous Is command(s) with more(l). 

help 

? Prints a brief summary of commands. 

set keyword[-value] 

This command is used to change state information that affects the lookups. 
Valid keywords are: 

all Prints the current values of the various options to set. Information about /" 

the current default server and host is also printed. V 

[no]debug 

Turn debugging mode on. A lot more information is printed about the 
packet sent to the server and the resulting answer. 
(Default = nodebug, abbreviation = [no] deb) 

[no]d2 

Turn exhaustive debugging mode on. Essentially all fields of every 
packet are printed. 
(Default = nod2) 

[no] defname 

Append the default domain name to every lookup. 
(Default = defname, abbreviation = [no]def) 

[nolsearch 

With defname, search for each name in parent domains of the current 

domain. 

(Default = search) 

domain=narae 

Change the default domain name to name! The default domain name is 
appended to all lookup requests if the defname option has been set. The 
search list is set to parents of the domain with at least two components in 
their names. 
(Default = value in hostname or /etc/resolv.conf, abbreviation = do) 



query type=value 



( 
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typ e=value 

Change the type of information returned from a query to one of: 

A the host's Internet address (the default). 

CNAME the canonical name for an alias. 

the host CPU and operating system type. 

the mail destination. 

the mail exchanger. 

the mail group member. 

the mailbox or mail list information. 

the mail rename domain name. 



HINFO 

MD 

MX 

MG 

MINFO 

MR 

NS 



nameserver for the named zone. Other types specified in the 
RFC883 document are valid but aren't very useful. 
(Abbreviation = q) 

[no]recurse 

Tell the name server to query other servers if it does not have the infor- 
mation. 
(Default = recurse, abbreviation = [no]rec) 

retry=number 

Set the number of retries to number. When a reply to a request is not 
received within a certain amount of time (changed with set timeout), the 
request is resent. The retry value controls how many times a request is 
resent before giving up. 
(Default = 2, abbreviation = ret) 

root-host 

Change the name of the root server to host. This affects the root command. 
(Default = sri-nic.arpa, abbreviation = ro) 

timeout=number 

Change the time-out interval for waiting for a reply to number seconds. 
(Default =10 seconds, abbreviation = t) 

[no]vc 

Always use a virtual circuit when sending requests to the server. 
(Default = novc, abbreviation = [no]v) 

If the lookup request was not successful, an error message is printed. Possible errors 
are: 

Time-out 

The server did not respond to a request after a certain amount of time (changed 
with set timeout=value) and a certain number of retries (changed with set 

retry =value). 

No information 

Depending on the query type set with the set querytype command, no infor- 
mation about the host was available, though the host name is valid. 

Non-existent domain 

The host or domain name does not exist. 
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Connection refused 
Network is unreachable 

The connection to the name or finger server could not be made at the current 

time. This error commonly occurs with finger requests. 

Server failure 

The name server found an internal inconsistency in its database and could not 
return a valid answer. 

Refused 

The name server refused to service the request. 

The following error should not occur and it indicates a bug in the program. 

Format error 

The name server found that the request packet was not in the proper format. 



( 



FILES 
SEE ALSO 
AUTHOR 



/etc/resolv.conf initial domain name and name server addresses. 



resolver(3), resolver(5), named(8), RFC882, RFC883 



Andrew Cherenson 
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WARNING 



NVRAM (1M) 



nvram - display or set values of NVRAM variables 

/etc/nvram [name=value] 

nvram without any parameters displays the current values set in the system non- 
volatile memory. Each line displayed contains an NVRAM variable name, followed 
by an equals sign, followed by a string. For example, typing nvram might display 

baud=9600 

etheraddr=00-00-7a-80-00-01 

netaddr=192.9.200.160 

hostname=ca 

screen_font=2 

path=bfs() 

screen_back=403050 

bootmode=a 

screen_fore=cc8800 

rootdev=scsi(0,5,0) 

swapdev=scsi(0,5,l ) 

bootfile=scsi(0,5,8)sash 

dumpdev=scsi (0,5,1) 

console=graphics 

nvram can also be used to remove an NVRAM variable, add an NVRAM variable, or 
remove an NVRAM variable. Typing 

nvram name= 
removes name from the list of name/value pairs stored. 
Typing 

nvram name=value 

where name is an existing NVRAM variable name will change its contents to the 
string typed. If the name does not already exist, then it is added to the list of 
name/value pairs. 

The value part can be any arbitrary collection of charaters. 

Only the super-user is allowed to remove or alter NVRAM values. 
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DESCRIPTION 



OAWK(1) 



oawk - pattern scanning and processing language 

oawk [ -Fc ] [ prog ] [ parameters ] [ files ] 

oawk scans each input file for lines that match any of a set of patterns specified in 
prog. With each pattern in prog there can be an associated action that will be per- 
formed when a line of a file matches the pattern. The set of patterns may appear 
literally as prog, or in a file specified as -f file. The prog string should be enclosed in 
single quotes O to protect it from the shell. 

Parameters, in the form x=... y=... etc., may be passed to oawk. 

Files are read in order; if there are no files, the standard input is read. The file name 
- means the standard input. Each line is matched against the pattern portion of 
every pattern-action statement; the associated action is performed for each matched 
pattern. 

An input line is made up of fields separated by white space. (This default can be 
changed by using FS; see below). The fields are denoted $1, $2, . . . ; $0 refers to the 
entire line. 

A pattern-action statement has the form: 

pattern { action } 

A missing action means print the line; a missing pattern always matches. An action 
is a sequence of statements. A statement can be one of the following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] . . . } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, new-lines, or right braces. An empty 
expression-list stands for the whole line. Expressions take on string or numeric 
values as appropriate, and are built using the operators +, -, *, /, %, and concatena- 
tion (indicated by a blank). The C operators ++, — , +=, -=, *=, /=, and %= are also 
available in expressions. Variables may be scalars, array elements (denoted x[i]) or 
fields. Variables are initialized to the null string. Array subscripts may be any string, 
not necessarily numeric; this allows for a form of associative memory. String con- 
stants are quoted ("). 
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The print statement prints its arguments on the standard output (or on a file if >expr 
is present), separated by the current output field separator, and terminated by the 
output record separator. The printf statement formats its expression list according to 
the format [see printf OS) in the Programmer's Reference Manual], 

The built-in function length returns the length of its argument taken as a string, or of 
the whole line if no argument. There are also built-in functions exp, log, sqrt, and int. 
The last truncates its argument to an integer; substr(s, m, n) returns the n-character 
substring of s that begins at position m. The function sprintf{fmt, expr, expr, ...) for- 
mats the expressions according to the printf "(3S) format given by fmt and returns the 
resulting string. 

Patterns are arbitrary Boolean combinations ( !, II, &&, and parentheses) of regular 
expressions and relational expressions. Regular expressions must be surrounded by 
slashes and are as in egrep (see grepd)). Isolated regular expressions in a pattern 
apply to the entire line. Regular expressions may also occur in relational expressions. 
A pattern may consist of two patterns separated by a comma; in this case, the action 
is performed for all lines between an occurrence of the first pattern and the next 
occurrence of the second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is either (for 
contains) or ! (for does not contain). A conditional is an arithmetic expression, a rela- 
tional expression, or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control before the first 
input line is read and after the last. BEGIN must be the first pattern, END the last. 

A single character c may be used to separate the fields by starting the program with: 

BEGIN { FS = c } 

or by using the -Fc option. 

Other variable names with special meanings include NF, the number of fields in the 
current record; NR, the ordinal number of the current record; FILENAME, the name of 
the current input file; OFS, the output field separator (default blank); ORS, the output 
record separator (default new-line); and OFMT, the output format for numbers 
(default %.6g). 

Print lines longer than 72 characters: 

length > 72 
Print first two fields in opposite order: 

{ print $2, $1 } 

Add up first column, print sum and average: 

{ s += $1 } 
END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; — i) print $i } 
Print all lines between start/ stop pairs: 
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/start/, /stop/ I 

Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 

Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 
{ print } 

command line: oawk -f program n=5 input 

SEE ALSO 

awk(l), grep(l), lex(l), sed(l), printf(3S) 

BUGS 

Input white space is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To force an expres- 
sion to be treated as a number add to it; to force it to be treated as a string concaten- 
ate the null string ("") to it. 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



OD(1) 



od - octal dump 

od [ -bcdosx ] [ file ] [ [ + ]offset[ . ][ b ] ] 

od dumps file in one or more formats as selected by the first argument. If the first 
argument is missing, -o is default. The meanings of the format options are: 

-b Interpret bytes in octal. 

-c Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: 
null=\0, backspace=\b, form-feed=\f, new-line=\n, return=\r, tab=\t; others 
appear as 3-digit octal numbers. 

-d Interpret words in unsigned decimal. 

-o Interpret words in octal. 

-s Interpret 16-bit words in signed decimal. 

-x Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file argument is 
specified, the standard input is used. 

The offset -argument specifies the offset in the file where dumping is to commence. 
This argument is normally interpreted as octal bytes. If . is appended, the offset is 
interpreted in decimal. If b is appended, the offset is interpreted in blocks of 512 
bytes. If the file argument is omitted, the offset argument must be preceded by +. 

Dumping continues until end-of-file. 
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NAME 
SYNOPSIS 



DESCRIPTION 



PACK(1) 



pack, peat, unpack - compress and expand files 

pack [ - ] [ -f ] name . . . 
peat name ... 
unpack name . . . 

pack attempts to store the specified files in a compressed form. Wherever possible 
(and useful), each input file name is replaced by a packed file name. 2. with the same 
access modes, access and modified dates, and owner as those of name. The -f option 
will force packing of name . This is useful for causing an entire directory to be packed 
even if some of the files will not benefit. If pack is successful, name will be removed. 
Packed files can be restored to their original form using unpack or peat . 

pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the - 
argument is used, an internal flag is set that causes the number of times each byte is 
used, its relative frequency, and the code for the byte to be printed on the standard 
output. Additional occurrences of - in place of name will cause the internal flag to be 
set and reset. 

The amount of compression obtained depends on the size of the input file and the 
character frequency distribution. Because a decoding tree forms the first part of each 
.z file, it is usually not worthwhile to pack files smaller than three blocks, unless the 
character frequency distribution is very skewed, which may occur with printer plots 
or pictures. 

Typically, text files are reduced to 60-75% of their original size. Load modules, 
which use a larger character set and have a more uniform distribution of characters, 
show little compression, the packed versions being about 90% of the original size. 

pack returns a value that is the number of files that it failed to compress. 

No packing will occur if: 

the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 

a file called name.z already exists; 

the ,z file cannot be created; 

an I/O error occurred during processing. 

The last segment of the file name must contain no more than 12 characters to allow 
space for the appended ,z extension. Directories cannot be compressed. 

Peat does for packed files what cat (I) does for ordinary files, except that peat cannot 
be used as a filter. The specified files are unpacked and written to the standard out- 
put. Thus to view a packed file named name a. use: 

peat name.z or just: peat name 

To make an unpacked copy, say nnn, of a packed file named name.z (without des- 
troying name.z) use the command: 

peat name >nnn 
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Peat returns the number of files it was unable to unpack. Failure may occur if: 

the file name (exclusive of the .z) has more than 12 characters; 

the file cannot be opened; 

the file does not appear to be the output of pack. 

Unpack expands files created by pack. For each file name specified in the command, a 
search is made for a file called name.z (or just name, if name ends in .z). If this file 
appears to be a packed file, it is replaced by its expanded version. The new file has 
the .z suffix stripped from its name, and has the same access modes, access and 
modification dates, and owner as those of the packed file. 

Unpack returns a value that is the number of files it was unable to unpack. Failure 
may occur for the same reasons that it may in peat, as well as for the following: 

a file with the "unpacked" name already exists; 
if the unpacked file cannot be created. 

SEE ALSO 

cat(l). 
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NAME 



pagesize - print system page size 

SYNOPSIS 

pagesize 

DESCRIPTION 

Pagesize prints the size of a page of memory in bytes, as returned by getpagesize(2). 
This program is useful in constructing portable shell scripts. 

SEE ALSO 

getpagesize(2) 



( 
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NAME 

pal - turn on/off PAL video mode 

pal on I off 

pal on sets the graphics subsystem into pal mode, and pal off restores the video to 
high-resolution. In pal mode, the upper left 640 by 480 pixels will be visible on a low 
resolution RGB monitor. 

It is recommended that "pal off" be bound to some key/button combination under 
the window system, such as <METAxSHIFT><CONTROLxRight-Button>. This 
way, independent of where the cursor is or the state of the window system, the moni- 
tor can be returned to high-resolution mode. 

SEE ALSO 

rsl70(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 



PASSWD (1) 



passwd - change login password 
passwd [ name ] 

This command changes or installs a password associated with the login name. 

Ordinary users may change only the password which corresponds to their login 
name. 

passwd prompts ordinary users for their old password, if any. It then prompts for the 
new password twice. The first time the new password is entered passwd checks to see 
if the old password has "aged" sufficiently. Password "aging" is the amount of time 
(usually a certain number of days) that must elapse between password changes. If 
"aging" is insufficient the new password is rejected and passwd terminates; see 
passwd (4). 

Assuming "aging" is sufficient, a check is made to insure that the new password 
meets construction requirements. When the new password is entered a second time, 
the two copies of the new password are compared. If the two copies are not identical 
the cycle of prompting for the new password is repeated for at most two more times. 

Passwords must be constructed to meet the following requirements: 

Each password must have at least six characters. Only the first eight characters 
are significant. 

Each password must contain at least two alphabetic characters and at least one 
numeric or special character. In this case, "alphabetic" means upper and lower 
case letters. 

Each password must differ from the user's login name and any reverse or circu- 
lar shift of that login name. For comparison purposes, an upper case letter and 
its corresponding lower case letter are equivalent. 

New passwords must differ from the old by at least three characters. For com- 
parison purposes, an upper case letter and its corresponding lower case letter 
are equivalent. 

One whose effective user ID is zero is called a super-user; see id{\), and su(l). 
Super-users may change any password; hence, passwd does not prompt super-users 
for the old password. Super-users are not forced to comply with password aging 
and password construction requirements. A super-user can create a null password 
by entering a carriage return in response to the prompt for a new password. 

/etc/passwd 

chfn(l), chsh(l), id(lM), login(l), su(lM), crypt(3C), passwd(4) 
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NAME 
SYNOPSIS 

DESCRIPTION 



EXAMPLES 



SEE ALSO 
DIAGNOSTICS 



PASTE (1) 



paste - merge same lines of several files or subsequent lines of one file 

paste filel file2 . . . 
paste -d list filel file2 ... 
paste -s [-d list ] filel file2 . . . 

In the first two forms, paste concatenates corresponding lines of the given input files 
filel, filel, etc. It treats each file as a column or columns of a table and pastes them 
together horizontally (parallel merging). If you will, it is the counterpart of cat(l) 
which concatenates vertically, i.e., one file after the other. In the last form above, 
paste replaces the function of an older command with the same name by combining 
subsequent lines of the input file (serial merging). In all cases, lines are glued 
together with the tab character, or with characters from an optionally specified list. 
Output is to the standard output, so it can be used as the start of a pipe, or as a filter, 
if - is used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each but the last file (or last line 
in case of the -s option) are replaced by a tab character. This option allows 
replacing the tab character by one or more alternate characters (see below). 

list One or more characters immediately following -d replace the default tab as the 
line concatenation character. The list is used circularly, i.e., when exhausted, it 
is reused. In parallel merging (i.e., no -s option), the lines from the last file are 
always terminated with a new-line character, not from the list. The list may 
contain the special escape sequences: \n (new-line), \t (tab), \\ (backslash), 
and \0 (empty string, not a null character). Quoting may be necessary, if char- 
acters have special meaning to the shell (e.g., to get one backslash, use 
-d"\\\\"). 



-s 



Merge subsequent lines rather than one from each input file. Use tab for con- 
catenation, unless a list is specified with -d option. Regardless of the list, the 
very last character of the file is forced to be a new-line. 

May be used in place of any file name, to read a line from the standard input. 
(There is no prompting). 



Is I paste -d" " - 

Is I paste 

paste -s -d M \ t\ n" file 

cut(l),grep(l),pr(l). 



list directory in one column 
list directory in four columns 
combine pairs of lines into lines 



line too long Output lines are restricted to 511 characters. 

too many files Except for -s option, no more than 12 input files may be 

specified. 
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NAME 

SYNOPSIS 

DESCRIPTION 



PG(1) 



pg - file perusal filter for CRTs 

pg [-number] [-p string] [-cefns] [+linenumber] [+/pattern/] [files...] 

The pg command is a filter which allows the examination of files one screenful at a 
time on a CRT. (The file name - and /or NULL arguments indicate that pg should 
read from the standard input.) Each screenful is followed by a prompt. If the user 
types a carriage return, another page is displayed; other possibilities are enumerated 
below. 

This command is different from previous paginators in that it allows you to back up 
and review something that has already passed. The method for doing this is 
explained below. 

In order to determine terminal attributes, pg scans the terminfo(4d data base for the 
terminal type specified by the environment variable TERM. If TERM is not defined, 
the terminal type dumb is assumed. 

The command line options are: 

-number 

An integer specifying the size (in lines) of the window that pg is to use instead 
of the default. (On a terminal containing 24 lines, the default window size is 
23). 

-p string 

Causes pg to use string as the prompt. If the prompt string contains a "%d", the 
first occurrence of "%d" in the prompt will be replaced by the current page 
number when the prompt is issued. The default prompt string is ":". 

-c Home the cursor and clear the screen before displaying each page. This option 
is ignored if clear_screen is not defined for this terminal type in the terminfo(4d 
data base. 

-e 



-f 



-n 



-s 



Causes pg not to pause at the end of each file. 

Normally, pg splits lines longer than the screen width, but some sequences of 
characters in the text being displayed (e.g., escape sequences for underlining) 
generate undesirable results. The -/ option inhibits pg from splitting lines. 

Normally, commands must be terminated by a <newline> character. This 
option causes an automatic end of command as soon as a command letter is 
entered. 

Causes pg to print all messages and prompts in standout mode (usually inverse 
video). 

+linenumber 

Start up at linenumber. 

^■/pattern/ 

Start up at the first line containing the regular expression pattern. 

The responses that may be typed when pg pauses can be divided into three 
categories: those causing further perusal, those that search, and those that modify the 
perusal environment. 

Commands which cause further perusal normally take a preceding address, an 
optionally signed number indicating the point from which further text should be 
displayed. This address is interpreted in either pages or lines depending on the com- 
mand. A signed address specifies a point relative to the current page or line, and an 
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unsigned address specifies an address relative to the beginning of the file. Each com- 
mand has a default address that is used if none is provided. 

The perusal commands and their defaults are as follows: 

(+l)<newline> or <blank> 

This causes one page to be displayed. The address is specified in pages. 

(+1)1 

With a relative address this causes pg to simulate scrolling the screen, forward 
or backward, the number of lines specified. With an absolute address this com- 
mand prints a screenful beginning at the specified line. 

(+l)dor A D 

Simulates scrolling half a screen forward or backward. 

The following perusal commands take no address . 

. or A L 

Typing a single period causes the current page of text to be redisplayed. 

$ Displays the last windowful in the file. Use with caution when the input is a 

pipe. 
The following commands are available for searching for text patterns in the text. The 
regular expressions described in ed{\) are available. They must always be terminated 
by a <newline>, even if the -n option is specified. 

i/pattern/ 

Search forward for the ith (default i=l) occurrence of pattern. Searching begins 
immediately after the current page and continues to the end of the current file, 
without wrap-around. 

i A pattern A 

ilpattern? 

Search backwards for the ith (default i=l) occurrence of pattern. Searching 
begins immediately before the current page and continues to the beginning of 
the current file, without wrap-around. The A notation is useful for Adds 100 
terminals which will not properly handle the ?. 

After searching, pg will normally display the line found at the top of the screen. This 
can be modified by appending m or b to the search command to leave the line found 
in the middle or at the bottom of the window from now on. The suffix t can be used 
to restore the original situation. 
The user of pg can modify the environment of perusal with the following commands: 

in Begin perusing the ith next file in the command line. The i is an unsigned 

number, default value is 1. 
ip Begin perusing the ith previous file in the command line, i is an unsigned 

number, default is 1. 
ivr Display another window of text. If i is present, set the window size to i. 

s filename 

Save the input in the named file. Only the current file being perused is saved. 
The white space between the s and filename is optional. This command must 
always be terminated by a <newline>, even if the -n option is specified. 

h Help by displaying an abbreviated summary of available commands. 

qor Q 

Quitpg. 
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EXAMPLE 



NOTES 



FILES 

SEE ALSO 
BUGS 



PG(1) 



kommand 

Command is passed to the shell, whose name is taken from the SHELL environ- 
ment variable. If this is not available, the default shell is used. This command 
must always be terminated by a <newline>, even if the -n option is specified. 

At any time when output is being sent to the terminal, the user can hit the quit key 
(normally controlA) or the interrupt (break) key. This causes pg to stop sending out- 
put, and display the prompt. The user may then enter one of the above commands in 
the normal manner. Unfortunately, some output is lost when this is done, due to the 
fact that any characters waiting in the terminal's output queue are flushed when the 
quit signal occurs. 

If the standard output is not a terminal, then pg acts just like cat(l), except that a 
header is printed before each file (if there is more than one). 

A sample usage of pg in reading system news would be 
news I pg -p "(Page %d):" 

While waiting for terminal input, pg responds to BREAK, DEL, and A by terminating 
execution. Between prompts, however, these signals interrupt pg's current task and 
place the user in prompt mode. These should be used with caution when input is 
being read from a pipe, since an interrupt is likely to terminate the other commands 
in the pipeline. 

Users of Berkeley's more will find that the z and f commands are available, and that 
the terminal /, A , or ? may be omitted from the searching commands. 



/usr/lib/terminfo/?/ * 
/tmp/pg* 

ed(l), grep(l), terminfo(4). 



terminal information database 
temporary file when input is from a pipe 



If terminal tabs are not set every eight positions, undesirable results may occur. 

When using pg as a filter with another command that changes the terminal I/O 
options terminal settings may not be restored correctly. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
WARNING 



PLED(1M) 

pled - control the front panel LED 

/etc/pled [on I off I flash] 

pled controls the red LED (light emitting diode) located beneath the system name 
plate on the front of the system cabinet. The main purpose is to signal particular 
phases of the boot procedure. The options are as follows: 

on turns the red LED on 

off turns the red LED off 

flash sets the red LED flashing, approximately once per second 

sysmips(2) in the Programmer's Reference Manual 

This command can be run only by the super-user. 
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pr - print files 

pr [ [-column] [-wwidth] [-a] ] [-eck] [-ick] [-drtfp] [+page] [-nek] [-ooffset] 
[-llength] [-sseparator] [-h header] [file ...] 

pr [ [-m] [-wwidth] ] [-eck] [-ick] [-drtfp] [+page] [-nek] [-ooffset] [-llength] 
[-sseparator] [-h header] filel file2 ... 



pr is used to format and print the contents of a file. If file is -, or if no files are 
specified, pr assumes standard input, pr prints the named files on standard output. 

By default, the listing is separated into pages, each headed by the page number, a 
date and time, and the name of the file. Page length is 66 lines which includes 10 
lines of header and trailer output. The header is composed of 2 blank lines, 1 line of 
text ( can be altered with -h), and 2 blank lines; the trailer is 5 blank lines. For single 
column output, line width may not be set and is unlimited. For multicolumn output, 
line width may be set and the default is 72 columns. Diagnostic reports (failed 
options) are reported at the end of standard output associated with a terminal, rather 
than interspersed in the output. Pages are separated by series of line feeds rather 
than form feed characters. 

By default, columns are of equal width, separated by at least one space; lines which 
do not fit are truncated. If the -s option is used, lines are not truncated and columns 
are separated by the separator character. 

Either -column or -m should be used to produce multi-column output, -a should 
only be used with -column and not -m. 

Command line options are 

+page 

Begin printing with page numbered page (default is 1). 

-column 

Print column columns of output (default is 1). Output appears as if -e and -i 
are turned on for multi-column output. May not use with -m. 

Print multi-column output across the page one line per column, columns must 
be greater than one. If a line is too long to fit in a column, it is truncated. 

Merge and print all files simultaneously, one per column. The maximum 
number of files that may be specifed is eight. If a line is too long to fit in a 
column, it is truncated. May not use with -column. 

Double-space the output. Blank lines that result from double-spacing are 
dropped when they occur at the top of a page. 

-eck Expand input tabs to character positions fc+1, 2*fc+l, 3*fc+l, etc. If k is or is 
omitted, default tab settings at every eighth position are assumed. Tab charac- 
ters in the input are expanded into the appropriate number of spaces. If c (any 
non-digit character) is given, it is treated as the input tab character (default for 
c is the tab character). 

-ick In output, replace white space wherever possible by inserting tabs to character 
positions fc+1, 2*fc+l, 3*fc+l, etc. If k is or is omitted, default tab settings at 
every eighth position are assumed. If c (any non-digit character) is given, it is 
treated as the output tab character (default for c is the tab character). 



-a 



-m 



-d 
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-nek Provide fc-digit line numbering (default for k is 5). The number occupies the 
first fc+1 character positions of each column of single column output or each 
line of -m output. If c (any non-digit character) is given, it is appended to the 
line number to separate it from whatever follows (default for c is a tab). 

-wzoidth 

Set the width of a line to width character positions (default is 72). This is effec- 
tive only for multi-column output (-column and -m). There is no line limit for 
single column output. 

-ooffset 

Offset each line by offset character positions (default is 0). The number of char- 
acter positions per line is the sum of the width and offset. 

-llength 

Set the length of a page to length lines (default is 66). -10 is reset to -166. When 
the value of length is 10 or less, -t appears to be in effect since headers and 
trailers are suppressed. By default, output contains 5 lines of header and 5 lines 
of trailer leaving 56 lines for user-supplied text. When -llength is used and 
length exceeds 10, then length-10 lines are left per page for user supplied text. 
When length is 10 or less, header and trailer output is omitted to make room for 
user supplied text. 

-h header 

Use header as the text line of the header to be printed instead of the file name. 
-h is ignored when -t is specified or -llength is specified and the value of length 
is 10 or less, (-h is the only pr option requiring space between the option and 
argument.) 

-p Pause before beginning each page if the output is directed to a terminal (pr will 
ring the bell at the terminal and wait for a carriage return). 

-f Use single form-feed character for new pages (default is to use a sequence of 
line-feeds). Pause before beginning the first page if the standard output is asso- 
ciated with a terminal. 

-r Print no diagnostic reports on files that will not open. 

-t Print neither the five-line identifying header nor the five-line trailer normally 
supplied for each page. Quit printing after the last line of each file without 
spacing to the end of the page. Use of -t overrides the -h option. 

-^separator 

Separate columns by the single character separator instead of by the appropriate 
number of spaces (default for separator is a tab). Prevents truncation of lines on 
multicolumn output unless -w is specified. 

EXAMPLES 

Print filel and file2 as a double-spaced, three-column listing headed by "file list": 

pr -3dh "file list" filel file2 

Copy filel to file2, expanding tabs to columns 10, 19, 28, 37, ... : 

pr -e9 -t <filel >file2 

Print filel and file2 simultaneously in a two-column listing with no header or trailer 
where both columns have line numbers: 



pr -t -n filel I pr -t -m -n file2 - 



FILES 
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/dev/tty* to delay messages enabling them to print at the bottom of files rather I 

than interspersed throughout printed output. - 

SEE ALSO 

cat(l), pg(l). 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



printenv - print out the environment 

printenv [ name ] 

printenv prints out the values of the variables in the environment. If a name is 
specified, only its value is printed. 

If a name is specified and it is not defined in the environment, printenv returns exit 
status 1, else it returns status 0. 

sh(l), environ(7), csh(l) 



Stardent 1500/3000 



343 



User Commands 



PRMAIL(1) 

NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 



PRMAIL(1) 

prrnail - print out mail in the post office 

prmail [ user... ] 

prrnail prints the mail which waits for you, or the specified user, in the post office. 
The mail is not disturbed. 

/usr/ spool/mail/ * post office 

biff(l), mail(l), from(l) binmail(l) 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 



prof, mkprof - display profile data 

prof [-v] [prog] 

mkprof [-Stt] [-Tletter] inprog outprog 

The prof command interprets a profile file (called mon.out ) produced by running a 
profiled program. The symbol table in the object file prog (a.out by default) is read 
and correlated with the profile file. For each function the number of calls of that rou- 
tine and the total time spent in each routine are reported. In the event that the pro- 
gram ran multiprocessor, the number of calls and the total time are reported for each 
thread of the process. If the [-v] option is in force, the percentage of the total time, 
and the average time per call are also reported. 

There are two ways to profile a program. A program creates a profile file if it has 
been loaded with the -p option of cc(l) or fed). Note that, unlike most other UNIX 
implementations, it is not necessary to recompile each routine with -p to obtain rou- 
tine counts; the effect takes place on the loading step. 

The other way to profile is to use the mkprof command. To create a profiled version 
yyy of the program xxx the command mkprof xxx yyy is run. When yyy is run, a 
mon.out file is produce which can be interpreted by prof. 

There are two options that can be accessed by mkprof only. The option -sn sets the 
scale factor to n. The hardware clock is in ticks (16ths of a microsecond). The scale 
factor tells how many bits to shift this to obtain the time that is reported by the 
profiler. By default, the scale factor is 4, which means that the default unit of time is 
microseconds. By increasing the scale factor, long-running programs can be timed 
with no danger of overflowing the (32-bit) counters. The scale factor is kept in the 
mon.out file and is automatically picked up and interpreted by prof. 

The option -Tletter allows you to specify a particular timing function. If letter is /, the 
FPU time is used (the default setting). If letter is c, the CPU time is used. If letter is e, 
the elapsed time is used. The letter specified in letter can be in either upper or lower 
case. CPU time and elapsed time are always measured in ticks (hundredths of a 
second). The -s (scale) option is ignored when either -Tc or -Te is specified. 

mon.out for profile 
a.out for namelist 



SEE ALSO 

cc(l),fc(l),ld(l) 

WARNINGS AND BUGS 

The times reported in successive identical runs may show variances due to sharing of 
the cache with other processes and other effects. 

Certain effects (e.g., paging, ETLB misses) may have a significant effect on the real- 
time performance of programs, but will not show up in these profiled numbers. 

There is a very slight chance that, on long programs on busy machines, the clock will 
'turn over' at the wrong time and some routine will be charged for 2**35 (i.e 2 to the 
power of 35) extra clock ticks. This i effect should be reasonably obvious. 

Call counts are always recorded precisely. 
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NAME 

SYNOPSIS 

DESCRIPTION 



PRS(1) 



prs - print an SCCS file 

prs [-d[dataspec]] [-r[SID]] [-e] [-1] [-c[date-time]] [-a] files 

prs prints, on the standard output, parts or all of an SCCS file [see sccsfile(£)] in a 
user-supplied format. If a directory is named, prs behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files (last component 
of the path name does not begin with s.), and unreadable files are silently ignored. If 
a name of - is given, the standard input is read; each line of the standard input is 
taken to be the name of an SCCS file or directory to be processed; non-SCCS files and 
unreadable files are silently ignored. 

Arguments to prs, which may appear in any order, consist of keyletter arguments, 
and file names. 

All the described keyletter arguments apply independently to each named file: 

-dldataspec] Used to specify the output data specification. The dataspec is a 
string consisting of SCCS file data keywords (see DATA KEY- 
WORDS ) interspersed with optional user supplied text. 



-t[S1D] 



-e 



-1 



-cldate-time] 



-a 



Used to specify the SCCS IDentification (SID) string of a delta 
for which information is desired. If no SID is specified, the SID 
of the most recently created delta is assumed. 

Requests information for all deltas created earlier than and 
including the delta designated via the -r keyletter or the date 
given by the -c option. 

Requests information for all deltas created later than and 
including the delta designated via the -r keyletter or the date 
given by the -c option. 

c date-time The cutoff date-time -c[cutoff]] is in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

Units omitted from the date-time default to their maximum 
possible values; that is, -c7502 is equivalent to -C750228235959. 
Any number of non-numeric characters may separate the vari- 
ous 2-digit pieces of the cutoff date in the form: ff -c77/2/2 
9:22:25". 

Requests printing of information for both removed, i.e., delta 
type = R, [see rtndeKD] and existing, i=e», delta type = D, del- 
tas. If the -a keyletter is not specified, information for existing 
deltas only is provided. 



DATA KEYWORDS 



Data keywords specify which parts of an SCCS file are to be retrieved and output. All 
parts of an SCCS file [see sccsfile(4)] have an associated data keyword. There is no 
limit on the number of times a data keyword may appear in a dataspec. 

The information printed by prs consists of: (1) the user-supplied text; and (2) 
appropriate values (extracted from the SCCS file) substituted for the recognized data 
keywords in the order of appearance in the dataspec. The format of a data keyword 
value is either Simple (S), in which keyword substitution is direct, or Multi-line (M), 
in which keyword substitution is followed by a carriage return. 



c 



( 



( 
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User-supplied text is any text other than recognized data keywords. 

A tab is specified by \t and carriage return/new-line is specified by \n. The default 

data keywords are: 

":Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:" 



TABLE 1. SCCS Files Data Keywords 



Keyword 


Data Item 


:Dt: 


Delta information 


:DL: 


Delta line statistics 


:Li: 


Lines inserted by Delta 


:Ld: 


Lines deleted by Delta 


:Lu: 


Lines unchanged by Delta 


:DT: 


Delta type 


•J: 


SCCS ID string (SID) 


:R: 


Release number 


:L: 


Level number 


:B: 


Branch number 


:S: 


Sequence number 


:D: 


Date Delta created 


:Dy: 


Year Delta created 


:Dm: 


Month Delta created 


:Dd: 


Day Delta created 


:T: 


Time Delta created 


:Th: 


Hour Delta created 


:Tm: 


Minutes Delta created 


:Ts: 


Seconds Delta created 


:P: 


Programmer who created Delta 


:DS: 


Delta sequence number 


:DP: 


Predecessor Delta seq-no. 


:DI: 


Seq-no. of deltas incl., excl., ignored 


:Dn: 


Deltas included (seq #) 


:Dx: 


Deltas excluded (seq #) 


:Dg: 


Deltas ignored (seq #) 


:MR: 


MR numbers for delta 


:C: 


Comments for delta 


:UN: 


User names 


:FL: 


Flag list 


:Y: 


Module type flag 


:MF: 


MR validation flag 


:MP: 


MR validation pgm name 


:KF: 


Keyword error/ warning flag 


:KV: 


Keyword validation string 


:BF: 


Branch flag 


:Js 


Joint edit flag 


:LK: 


Locked releases 


:Q: 


User-defined keyword 


:M: 


Module name 


:FB: 


Floor boundary 



File Section Value 
Delta Table See below* 
:Li:/:Ld:/:Lu: 


Format 
S 
S 




nnnnn 


s 




nnnnn 


s 




' nnnnn 


s 




D~or~R 
:R:.:L:.:B:.:S: 


s 
s 




nnnn 


s 




f nnnn 


s 




nnnn 


s 




nnnn 

:Dy:/:Dm:/:Dd: 

nn 


s 
s 
s 




nn 


s 




nn 


s 




:Th:::Tm:::Ts: 


s 




nn 


s 




' nn 


s 




nn 


s 




logname 


s 




' nnnn 


s 




nnnn 


s 


User! 
Flc 


:Dn:/:Dx:/:Dg: 

:DS:~:DS:... 

:DS:~:DS:... 

:DS:~:DS:... 

text 

text 

Sfames text 

igs text 

text 


s 
s 
s 
s 

M 
M 
M 
M 
S 




* yes -or -no 
text 


S 

s 




yes -or -no 
text 


s 
s 




yes-or-no 

' yes-or-no 

:R:... 

text 

text 

:R: 


s 
s 
s 
s 
s 
s 
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Keyword 
:CB: 
:Ds: 
:ND: 
:FD: 
:BD: 
:GB: 
:W: 

:A: 

:Z: 

:F: 
:PN: 



EXAMPLES 



Value 


Format 


:R: 


S 


:I: 


S 


yes ~or ~no 


S 


text 


M 


text 


M 


text 


M 


:Z::M:\t:I: 


S 


Z:;Y:~:M:~:I::Z: 


s 


®(#) 


s 


text 


s 


text 


s 



FILES 



SEE ALSO 



DIAGNOSTICS 



TABLE 1. SCCS Files Data Keywords (continued) 

Data Item File Section 

Ceiling boundary " 
Default SID 
Null delta flag 

File descriptive text Comments 

Body Body 

Gotten body " 

A form of what(l) string N/A 

A form of whatO) string N/A 

what (I) string delimiter N/A 

SCCS file name N/A 

SCCS file path name N/A 

* :Dt:-=~:DT:~:I:~:D:-:T:~:P:-:DS:~:DP: 

prs -d'TJsers and/or user IDs for :F: are:\n:UN: n s.file 

may produce on the standard output: 

Users and/ or user IDs for siile are: 

xyz 

131 

abc 

prs -d"Newest delta for pgm :Mn :I: Created :D: By :P:" -r siile 
may produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case: 

prs siile 

may produce on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 

MRs: 

M78-12345 

W79-54321 

COMMENTS: 

this is the comment line for siile initial delta 

for each delta table entry of the "D" type. The only keyletter argument allowed to be 
used with the special case is the —a keyletter. 

/tmp/pr????? 

admin(l), delta(l), get(l), help(l), sccsfile(4). 

Use help(l) for explanations. 



( 



( 



( 
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PS(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



PS(1) 



ps - report process status 

ps [ options ] 

ps prints certain information about active processes. Without options, information is 
printed about processes associated with the controlling terminal. The output consists 
of a short listing containing only the process ID, terminal identifier, cumulative exe- 
cution time, and the command name. Otherwise, the information that is displayed is 
controlled by the selection of options. 

Options accept names or lists as arguments. Arguments can be either separated from 
one another by commas or enclosed in double quotes and separated from one 
another by commas or spaces. Values for proclist and grplist must be numeric. 

The options are given in descending order according to volume and range of informa- 
tion provided: 

-e Print information about every process now running. 

-d Print information about all processes except process group leaders. 

-a Print information about all processes most frequently requested: all 

those except process group leaders and processes not associated with a 

terminal. 
-f Generate a full listing. (See below for significance of columns in a full 

listing.) 
-1 Generate a long listing. (See below.) 

-v Generate a memory usage oriented listing. (See below.) 

-w Generate a cpu and memory usage oriented listing. (See below.) 

-c corefile Use the file corefile in place of /dev/mem. 

-n name Take argument signifying an alternate system name in place of /unix. 
-t termlist List only process data associated with the terminal given in termlist. 

Terminal identifiers may be specified in one of two forms: the device's 

file name (e.g., tty04) or, if the device's file name starts with tty, just the 

digit identifier (e.g., 04). 
-p proclist List only process data whose process ID numbers are given in proclist. 
-u uidlist List only process data whose user ID number or login name is given in 

uidlist. In the listing, the numerical user ID will be printed unless you 

give the -f option, which prints the login name, 
-g grplist List only process data whose process group leader's ID number(s) 

appears in grplist. (A group leader is a process whose process ID 

number is identical to its process group ID number. A login shell is a 

common example of a process group leader.) 

Under the -f option, ps tries to determine the command name and arguments given 
when the process was created by examining the user block. Failing this, the com- 
mand name is printed, as it would have appeared without the -f option, in square 
brackets. 

The column headings and the meaning of the columns in a ps listing are given below; 
the letters f, 1, w, and v indicate the option (full, long cpu, or memory respectively) 
that cause the corresponding heading to appear; all means that the heading always 
appears. Note that these four options determine only what information is provided 
for a process; they do not determine which processes will be listed. 
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(1) Flags (hexadecimal and additive) associated with the process 

00 Process has terminated: process table entry now avail- 
able. 

01 A system process: always in primary memory. 

02 Parent is tracing process. 

04 Tracing parent's signal has stopped process: parent is 

waiting [ptrace(2)]. 

08 Process cannot be woken by a signal. 

10 Process currently in primary memory. 

20 Process is locked in memory and cannot be paged out 

until an event occurs. 

40 Parent's signal goes remote. 

100 Process on on run queue 

400 Process is doing I/O via Iproc. 

1 000 Process is open via Iproc . 

2000 Signal mask is restored on return from pause. 

4000 Use 4.3BSD signal semantics. 

8000 Process is a 4.3BSD process group leader. 

80000 Process needs to checkpoint the FPU. 

(l,w,v) The state of the process: 



O 

s 

R 

I 

Z 



X 



Process is running on a processor. 

Sleeping: process is waiting for an event to complete. 

Runnable: process is on run queue. 

Idle: process is being created. 

Zombie state: process terminated and parent not wait- 
ing. 

Traced: process stopped by a signal because parent is 
tracing it. 

SXBRK state: process is waiting for more primary 
memory. 



(l,w,v)" 



sz 



UID 



PID 



(1) 



Cpu on which the process last ran. 

The size (in pages or clicks) of the swappable process's image in 
main memory. 

(f,l,w) The user ID number of the process owner (the login name is 
printed under the -f option). 



(all) 



PPID (f,l) 

C (f,l) 

PRI (1) 

NI (1) 

WCHAN (1) 



The process ID of the process (this datum is necessary in order to 
kill a process). 

The process ID of the parent process. 

Processor utilization for scheduling. 

The priority of the process (higher numbers mean lower priority). 

Nice value, used in priority computation. 

The address of an event for which the process is sleeping, or in 
SXBRK state, (if blank, the process is running or ready to run). 



( 



c 
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FILES 



SEE ALSO 
WARNING 



STIME 

TTY 

TIME 
SL 

RE 

%CPU 



(f,w) 

(all) 

(all) 
(v) 

(v) 

(v,w) 



The starting time of the process, given in hours, minutes, and 
seconds. (A process begun more than twenty-four hours before 
the ps inquiry is executed is given in months and days.) 

The controlling terminal for the process (the message, ?, is printed 
when there is no controlling terminal). 

The cumulative execution time for the process. 

Number of seconds the process has been asleep. Will not show 
times in excess of 99 seconds. 

Number of seconds the process has been resident in main 
memory. Will not show times in excess of 99 seconds. 

Cpu utilization of the process; this is a decaying average over up 
to a minute of previous (real) time. Since the time base over 
which this is computed varies (since processes may be very 
young) it is possible for the sum of all %CPU fields to exceed 
100%. 



RSS 



(v,w) 



Number of kilobytes (1024) of real memory the process is 
currently using. Does not reflect shared text or data. 

Number of kilobytes (1024) of real memory the process is 
currently using, divided by the number of users of each shared 
region. 

Percentage of real memory in use by this process. Computed by 
dividing the SRSS figure by the amount of system memory avail- 
able for user processes. 

The command name (the full command name and its arguments 
are printed under the -f option). 

A process that has exited and has a parent, but has not yet been waited for by the 
parent, is marked <defunct>. 



SRSS 



%MEM 



COMD 



(v,w) 



(v,w) 



(all) 



/dev 

/dev/tty* 

/dev/kmem 

/dev/mem 

/etc/passwd 

/etc/ps_data 

/unix 



kernel virtual memory 

memory 

UID information supplier 

internal data structure 

system namelist 



getty(lM),kill(l),nice(l). 

Things can change while ps is running; the snap-shot it gives is only true for a split- 
second, and it may not be accurate by the time you see it. Some data printed for 
defunct processes is irrelevant. 

If no termlist, proclist, uidlist, or grplist is specified, ps checks stdin, stdout, and stderr in 
that order, looking for the controlling terminal and will attempt to report on 
processes associated with the controlling terminal. In this situation, if stdin, stdout, 
and stderr are all redirected, ps will not find a controlling terminal, so there will be no 
report. 
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On a heavily loaded system, ps may report an lseek(2) error and exit, ps may seek to I 

an invalid user area address: having got the address of a process' user area, ps may ^- 

not be able to seek to that address before the process exits and the address becomes 
invalid. 

ps -ef may not report the actual start of a tty login session, but rather an earlier time, 
when a getty was last respawned on the tty line. 



c 



c 
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PWCK(TM) 

NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



PWCK(1M) 



pwck, grpck - password/group file checkers 

/etc/pwck[file] 
/etc/grpck [file] 

pwck scans the password file and notes any inconsistencies. The checks include vali- 
dation of the number of fields, login name, user ID, group ID, and whether the login 
directory and the program-to-use-as-Shell exist. The default password file is 
/etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a check of the 
number of fields, group name, group ID, and whether all login names appear in the 
password file. The default group file is /etc/group. 

/etc/group 
/etc/passwd 

group(4), passwd(4). 

Group entries in /etc/group with no login names are flagged. 
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PWD(1) 



NAME 
SYNOPSIS 
DESCRIPTION 
SEE ALSO 
DIAGNOSTICS 



pwd - working directory name 



pwd 



pwd prints the path name of the working (current) directory. 



cd(l). 



"Cannot open .." and "Read error in .." indicate possible file system trouble and 
should be referred to a UNIX system administrator. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



ratfor - rational Fortran dialect 

ratfor [ option ... ] [ filename ... ] 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor 
provides control flow constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 



[ default: ] statement 



} 



loops: 



while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 

free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment 

translation of relational: 

>, >=, etc., become .GT., .GE., etc. 

return (expression) 

returns expression to caller from function 

define: 

define name replacement 

include: 

include filename 

B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

SYNOPSIS 

DESCRIPTION 



RC0(1M) 



FILES 



rcO - run commands performed to stop the operating system 

/etc/rcO 

This file is executed at each system state change that needs to have the system in an 
inactive state. It is responsible for those actions that bring the system to a quiescent 
state, traditionally called "shutdown". 

There are three system states that require this procedure. They are state (the sys- 
tem halt state), state 5 (the firmware state), and state 6 (the reboot state). Whenever a 
change to one of these states occurs, the /etc/rcO procedure is run. The entry in 
/etc/inittab might read: 

s0:056:wait:/etc/rc0 >/dev/console 2>&1 </dev/console 

Some of the actions performed by /etc/rcO are carried out by files in the directory 
/etc/shutdown.d. and files beginning with K in /etc/rcO.d. These files are executed in 
ASCII order (see FILES below for more information), terminating some system ser- 
vice. The combination of commands in /etc/rcO and files in /etc/shutdown.d and 
/etc/rcO.d determines how the system is shut down. 

The recommended sequence for /etc/rcO is: 

Stop System Services and Daemons. 

Various system services (such as 3BNET Local Area Network or LP Spooler) 
are gracefully terminated. 

When new services are added that should be terminated when the system is 
shut down, the appropriate files are installed in /etc/shutdown.d and /etc/rcO.d. 

Terminate Processes 

SIGTERM signals are sent to all running processes by killalKlM). Processes 
stop themselves cleanly if sent SIGTERM. 

Kill Processes 

SIGKILL signals are sent to all remaining processes; no process can resist SIG- 
KILL. 

At this point the only processes left are those associated with /etc/rcO and 
processes and 1, which are special to the operating system. 

Unmount All File Systems 

Only the root file system (/) remains mounted. 

Depending on which system state the systems end up in (0, 5, or 6), the entries in 
/etc/inittab will direct what happens next. If the /etc/inittab has not defined any 
other actions to be performed as in the case of system state 0, then the operating sys- 
tem will have nothing to do. It should not be possible to get the system's attention. 
The only thing that can be done is to turn off the power or possibly get the attention 
of a firmware monitor. The command can be used only by the super-user. 

The execution by /bin/sh of any files in /etc/shutdown.d occurs in ascii sort-sequence 
order. See rc2(lM) for more information. 
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SEE ALSO 



killall(lM), rc2(lM), shutdown(lM). 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLES 



RC2(1M) 



rc2 - run commands performed for multi-user environment 

/etc/rc2 

This file is executed via an entry in /etc/inittab and is responsible for those initializa- 
tions that bring the system to a ready-to-use state, traditionally state 2, called the 
"multi-user" state. 

The actions performed by jetcjrcl are found in files in the directory /etc/red and files 
beginning with S in /etc/rc2.d. These files are executed by /bin/sh in ASCII 
sort-sequence order (see FILES for more information). When functions are added 
that need to be initialized when the system goes multi-user, an appropriate file 
should be added in /etc/rc2.d. 

The functions done by /etc/rc2 command and associated /etc/rc2.d files include: 

Setting and exporting the TIMEZONE variable. 

Setting-up and mounting the user (/usr) file system. 

Cleaning up (remaking) the /tmp and /usr/tmp directories. 

Loading the network interface and ports cards with program data and starting 
the associated processes. 

Starting the cron daemon by executing /etc/cron. 

Cleaning up (deleting) uucp locks status, and temporary files in the 
/usr/spool/uucp directory. 

Other functions can be added, as required, to support the addition of hardware and 
software features. 

The following are prototypical files found in /etc/rc2.d. These files are prefixed by an 
S and a number indicating the execution order of the files. 

MOUNTFILESYS 

# Set up and mount file systems 

cd/ 

/etc/mountall /etc/fstab 

RMTMPFILES 

# clean up /tmp 

X X 

rm -rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 

uucp 

# clean-up uucp locks, status, and temporary files 

rm-rf /usr/spool/locks/* 

The file /etc/TIMEZONE is included early in \eic\rcl, thus establishing the default 
time zone for all commands that follow. 
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FILES 

Here are some hints about files in /etc/red: 

The order in which files are executed is important. Since they are executed in ASCII 
sort-sequence order, using the first character of the file name as a sequence indicator 
will help keep the proper order. Thus, files starting with the following characters 
would be: 

[0-9]. very early 

[A-Z]. early 

[a-n]. later 

[o-z]. last 

3.mountfs 

Files in /etc/red that begin with a dot (.) will not be executed. This feature can be 
used to hide files that are not to be executed for the time being without removing 
them. The command can be used only by the super-user. 

Files in /etc/rc2.d must begin with an S or a K followed by a number and the rest of 
the file name. Upon entering run level 2, files beginning with S are executed with the 
start option; files beginning with K, are executed with the stop option. Files begin- 
ning with other characters are ignored. 

SEE ALSO 

shutdown(lM). 
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NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



RCP(1C) 



rep - remote file copy 

rep [ -p ] filel file2 

rep [ -p ] [ -r ] file ... directory 

Rep copies files between machines. Each file or directory argument is either a remote 
file name of the form "rhost:path", or a local file name (containing no ':' characters, 
or a V' before any Ys). 

If the -r option is specified and any of the source files are directories, rep copies each 
subtree rooted at that name; in this case the destination must be a directory. 

By default, the mode and owner of file2 are preserved if it already existed; otherwise 
the mode of the source file modified by the umask(2) on the destination host is used. 
The -p option causes rep to attempt to preserve (duplicate) in its copies the 
modification times and modes of the source files, ignoring the umask. 

If path is not a full path name, it is interpreted relative to your login directory on 
rhost. A path on a remote host may be quoted (using \, ", or ) so that the metacharac- 
ters are interpreted remotely. 

Rep does not prompt for passwords; your current local user name must exist on rhost 
and allow remote command execution via rsh(lC). 

Rep handles third party copies, where neither source nor target files are on the 
current machine. Hostnames may also take the form "rname@rhost" to use rname 
rather than the current user name on the remote host. The destination hostname may 
also take the form "rhost.rname" to support destination machines that are running 
4.2BSD versions of rep. 

cp(l), ftp(lC), rsh(lC), rlogin(lC) 

Doesn't detect all cases where the target of a copy might be a file in cases where only 
a directory should be legal. 

Is confused by any output generated by commands in a .login, .profile, or .cshrc file 
on the remote host. 
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REGCMP(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLES 



SEE ALSO 



REGCMP(1) 



regcmp - regular expression compile 

regcmp [ - ] files 

The regcmp command performs a function similar to regcmp (3X) and, in most cases, 
precludes the need for calling regcmp (3X) from C programs. This saves on both exe- 
cution time and program size. The command regcmp compiles the regular expres- 
sions in file and places the output in file A. If the - option is used, the output will be 
placed in file.c. The format of entries in file is a name (C variable) followed by one or 
more blanks followed by a regular expression enclosed in double quotes. The output 
of regcmp is C source code. Compiled regular expressions are represented as extern 
char vectors. File A files may thus be included in C programs, or file.c files may be 
compiled and later loaded. In the C program which uses the regcmp output, 
regex(abc,line) will apply the regular expression named abc to line. Diagnostics are 
self-explanatory. 

name "([A-Za-z][A-Za-zO-9J*)$0" 

telno "\({0,1}([2-9][01][1-9])$0\){0,1} *" 
"([2-9][0-9]{2})$l[-]{0,l}" 
"([0-9]{4))$2 M 

In the C program that uses the regcmp output, 

regex(telno, line, area, exch, rest) 

will apply the regular expression named telno to line. 

regcmp(3X). 
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REV(1) REV(1) 

NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev [ file ] ... 

DESCRIPTION 

Rev copies the named files to the standard output, reversing the order of characters in 
every line. If no file is specified, the standard input is copied. 
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RLOGIN(1C) 

NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 






rsh(lC) 


FILES 






/usr/hosts/* 


BUGS 





RLOGIN (1C) 



rlogin - remote login 

rlogin rhost [ -e c ] [ -8 ] [ -L ] [ -1 username ] 
rhost [ -ec ] [ -8 ] [ -L ] [ -1 username ] 

Rlogin connects your terminal on the current local host system Ihost to the remote 
host system rhost 

Each host has a file /etc/hosts.equiv which contains a list of rhosfs with which it shares 
account names. (The host names must be the standard names as described in Ysh{\Q.) 
When you rlogin as the same user on an equivalent host, you don't need to give a 
password. Each user may also have a private equivalence list in a file .rhosts in his 
login directory. Each line in this file should contain an rhost and a username 
separated by a space, giving additional cases where logins without passwords are to 
be permitted. If the originating user is not equivalent to the remote user, then a login 
and password will be prompted for on the remote machine as in logind). To avoid 
some security problems, the .rhosts file must be owned by either the remote user or 
root. 

The remote terminal type is the same as your local terminal type (as given in your 
environment TERM variable). The terminal or window size is also copied to the 
remote system if the server supports the option, and changes in size are reflected as 
well. All echoing takes place at the remote site, so that (except for delays) the rlogin 
is transparent. Flow control via A S and A Q and flushing of input and output on 
interrupts are handled properly. The optional argument -8 allows an eight-bit input 
data path at all times; otherwise parity bits are stripped except when the remote 
side's stop and start characters are other than A S/ A Q. The argument -L allows the 
rlogin session to be run in litout mode. A line of the form "~." disconnects from the 
remote host, where "~" is the escape character. Similarly, the line "~ A Z" (where A Z, 
control-Z, is the suspend character) will suspend the rlogin session. Substitution of 
the delayed-suspend character (normally A Y) for the suspend character suspends the 
send portion of the rlogin, but allows output from the remote system. A different 
escape character may be specified by the -e option. There is no space separating this 
option flag and the argument character. 



for rhost version of the command 



More of the environment should be propagated. 
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RM{1) 

NAME 
SYNOPSIS 



DESCRIPTION 



RM(1) 



rm, rmdir - remove files or directories 

rm [-f] R] file ... 

rm -r [-f] [-i] dirname ... [file ...] 

rmdir [-p] [-s] dirname ... 

rm removes the entries for one or more files from a directory. If an entry was the last 
link to the file, the file is destroyed,, Removal of a file requires write permission in its 
directory, but neither read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, the full set of 
permissions (in octal) for the file are printed followed by a question mark. This is a 
prompt for confirmation. If the answer begins with y (for yes), the file is deleted, oth- 
erwise the file remains. 

Note that if the standard input is not a terminal, the command will operate as if the 
-f option is in effect. 

rmdir removes the named directories, which must be empty. 

Three options apply to rm: 

-f This option causes the removal of all files (whether write-pro tected or not) in a 
directory without prompting the user. In a write-protected directory, however, 
files are never removed (whatever their permissions are), but no messages are 
displayed. If the removal of a write-protected directory was attempted, this 
option cannot suppress an error message. 

-r This option causes the recursive removal of any directories and subdirectories 
in the argument list. The directory will be emptied of files and removed. Note 
that the user is normally prompted for removal of any write-protected files 
which the directory contains. The write-protected files are removed without 
prompting, however, if the -f option is used, or if the standard input is not a 
terminal and the -i option is not used. 

Note that the -r option does not cause rm to follow symbolic links to direc- 
tories. 

If the removal of a non-empty, write-protected directory was attempted, the 
command will always fail (even if the -f option is used), resulting in an error 
message. 

-i With this option, confirmation of removal of any write-protected file occurs 
interactively. It overrides the -f option and remains in effect even if the stan- 
dard input is not a terminal. 

Two options apply to rmdir: 

-p This option allows users to remove the directory dirname and its parent direc- 
tories which become empty. A message is printed on standard output as to 
whether the whole path is removed or part of the path remains for some rea- 
son. 

-s This option is used to suppress the message printed on standard error when -p 
is in effect. 
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RM(1) ™l(1) 

DIAGNOSTICS 

All messages are generally self-explanatory. 

It is forbidden to remove the files "." and V in order to avoid the consequences of 

inadvertently doing something like the following: 

rm-r .* 

Both rm and rmdir return exit codes of if all the specified directories are removed 
successfully. Otherwise, they return a non-zero exit code. 

SEE ALSO 

unlink(2), rmdir(2). 



Stardent 1500/3000 365 



Source Code Control System Utilities 



RMDEL (1) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



RMDEL(1) 



rmdel - remove a delta from an SCCS file 



rmdel -rSID files 



( 



rmdel removes the delta specified by the SID from each named SCCS file. The delta to 
be removed must be the newest (most recent) delta in its branch in the delta chain of 
each named SCCS file. In addition, the specified must not be that of a version being 
edited for the purpose of making a delta (i. e., if a p-file [see get(l)] exists for the 
named SCCS file, the specified must not appear in any entry of the p-file). 

The -r option is used for specifying the SID (SCCS Identification) level of the delta to 
be removed. 

If a directory is named, rmdel behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a name of - is 
given, the standard input is read; each line of the standard input is taken to be the 
name of an SCCS file to be processed; non-SCCS files and unreadable files are silently 
ignored. 

Simply stated, they are either (1) if you make a delta you can remove it; or (2) if you 
own the file and directory you can remove a delta. 



x.file^ 
z.file 



[see deltad)] 
[see delta (1)] 



delta(l), get(l), help(l), prs(l), sccsfile(4). 



Use help(l) for explanations. 
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RS170(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



RS170(1) 



rsl70 - turn on/off rsl70 video mode 



rsl70 on I off 



rsl70 on sets the graphics subsystem into rsl70 mode, and rsl70 off restores the 
video to high-resolution. In rsl70 mode, the upper left 640 by 480 pixels will be visi- 
ble on a low resolution RGB monitor. 

It is recommended that "rsYJQ off" be bound to some key /button combination under 
the window system, such as <META><SHIFT><CONTROL><Right-Button>. This 
way, independent of where the cursor is or the state of the window system, the moni- 
tor can be returned to high-resolution mode. 
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RSH(1C) 

NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
BUGS 



RSH(1C) 



rsh - remote shell 

rsh host [ -1 username ] [ -n ] command 
host [ -1 username ] [ -n ] command 

Rsh connects to the specified host, and executes the specified command. Rsh copies its 
standard input to the remote command, the standard output of the remote command 
to its standard output, and the standard error of the remote command to its standard 
error. Interrupt, quit and terminate signals are propagated to the remote command; 
rsh normally terminates when the remote command does. 

The remote username used is the same as your local username, unless you specify a 
different remote name with the -1 option. This remote name must be equivalent (in 
the sense of rlogin (1Q) to the originating account; no provision is made for specify- 
ing a password with a command. 

If you omit command, then instead of executing a single command, you will be logged 
in on the remote host using rlogin(lC). 

Shell metacharacters which are not quoted are interpreted on local machine, while 
quoted metacharacters are interpreted on the remote machine. Thus the command 

rsh otherhost cat remotefile » localfile 
appends the remote file remotefile to the localfile localfile, while 

rsh otherhost cat remotefile "»" otherremotefile 

appends remotefile to otherremotefile. 

Host names are given in the file /etc/hosts . Each host has one standard name (the first 
name given in the file), which is rather long and unambiguous, and optionally one or 
more nicknames. The host names for local machines are also commands in the direc- 
tory fusr /hosts; if you put this directory in your search path then the rsh can be omit- 
ted. 

/etc/hosts 
/usr/ hosts/* 

rlogin(lC) 

If you are using csh(l) and put a rsh(lC) in the background without redirecting its 
input away from the terminal, it will block even if no reads are posted by the remote 
command. If no input is desired you should redirect the input of rsh to /dev/null 
using the -n option. 

You cannot run an interactive command (like vi(\))- f use rlogin(lQ. 

Stop signals stop the local rsh process only; this is arguably wrong, but currently 
hard to fix for reasons too complicated to explain here. 
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RUNACCT(IM) 

NAME 

SYNOPSIS 

DESCRIPTION 



RUNACCT(IM) 



runacct - run daily accounting 

/usr/lib/acct/runacct [mmdd [state]] 

runacct is the main daily accounting shell procedure. It is normally initiated via 
cron(lM). runacct processes connect, fee, disk, and process accounting files. It also 
prepares summary files for prdaily or billing purposes, runacct is distributed only to 
source code licensees. 

runacct takes care not to damage active accounting files or summary files in the event 
of errors. It records its progress by writing descriptive diagnostic messages into 
active. When an error is detected, a message is written to I devl console, mail (see 
mailO)) is sent to root and adm, and runacct terminates, runacct uses a series of lock 
files to protect against re-invocation. The files lock and lockl are used to prevent 
simultaneous invocation, and lastdate is used to prevent more than one invocation 
per day. 

runacct breaks its processing into separate, restartable states using staiefile to 
remember the last state completed. It accomplishes this by writing the state name 
into statefile. runacct then looks in statefile to see what it has done and to determine 
what to process next, states are executed in the following order: 

SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date changes if neces- 
sary. 

CONNECTl Produce connect session records in ctmp.h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct.h format. 

MERGE Merge the connect and process accounting records. 

FEES Convert output of chargefee into tacct.h format and merge with 

connect and process accounting records. 

DISK Merge disk accounting records with connect, process, and fee 

accounting records. 



MERGETACCT 

CMS 
USEREXIT 



Merge the daily total accounting records in daytacct with the 
summary total accounting records in /usr/adm/acct/sum/tacct . 

Produce command summaries. 

Any installation-dependent accounting programs can be 
included here. 



CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnostics, then fix up 
any corrupted data files such as pacct or wtmp. The lock files and lastdate file must be 
removed before runacct can be restarted. The argument mmdd is necessary if runacct 
is being restarted, and specifies the month and day for which runacct will rerun the 
accounting. Entry point for processing is based on the contents of statefile; to over- 
ride this, include the desired state on the command line to designate where process- 
ing should begin. 
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RUNACCT(IM) 
EXAMPLES 



FILES 



SEE ALSO 



BUGS 



RUNACCT(tM) 



To start runacct. nohup runacct 2> /usr/adm/acct/nite/f d21og & 

To restart runacct. nohup runacct 0601 2» /usr/adm/acct/nite/f d21og & 

To restart runacct at a specific state, nohup runacct 0601 MERGE 2» 
/usr/adm/acct/nite/f d21og & 

/etc/wtmp 

/usr/adm/pacct* 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acct/ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acct/nite/daytacct 

/usr/adm/acct/nite/lock 

/usr/adm/acct/nite/lockl 

/usr/adm/acct/nite/lastdate 

/ usr / adm/ acct / nite / statefile 

/usr/adm/acct/nite/ptacct*. mmdd 

acct(lM), acct(2), acct(4), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctprc(lM), acctsh(lM), cron(lM), fwtmp(lM), mail(l), utmp(4) 

Normally it is not a good idea to restart runacct in the SETUP state. Run SETUP 
manually and restart via: 

runacct rnrndd WTMPFIX 

If runacct failed in the PROCESS state, remove the last ptacct file because it will not be 
complete. 
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RUPTIME(IC) 



RUPTIME(IC) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 



ruptime - show host status of local machines 

ruptime [-a] [-r][-l][-t][-u] 

ruptime gives a status line like uptime for each machine on the local network; these are 
formed from packets broadcast by each host on the network once a minute. 

Machines for which no status report has been received for 11 minutes are shown as 
being down. 

Users idle an hour or more are not counted unless the -a flag is given. 

Normally, the listing is sorted by host name. The -1 , -t , and -u flags specify sorting 
by load average, uptime, and number of users, respectively. The -r flag reverses the 
sort order. 

/usr/spool/rwho/whod.* data files 

rwho(lC) 
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RWHO(1C) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
BUGS 



RWHO(1C) 



rwho - who's logged in on local machines 

rwho [ -a ] 

The rwho command produces output similar to who, but for all machines on the local 
network. If no report has been received from a machine for 5 minutes then rwho 
assumes the machine is down, and does not report users last known to be logged into 
that machine. 

If a users hasn't typed to the system for a minute or more, then rwho reports this idle 
time. If a user hasn't typed to the system for an hour or more, then the user will be 
omitted from the output of rwho unless the -a flag is given. 

/usr/spool/rwho/whod.* information about other machines 

ruptime(lC), rwhod(8C) 

This is unwieldy when the number of machines on the local net is large. 
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SACT(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



SACT(1) 



sact - print current SCCS file editing activity 



sact files 



sact informs the user of any impending deltas to a named SCCS file. This situation 
occurs when get{\) with the -e option has been previously executed without a subse- 
quent execution of delta{\). If a directory is named on the command line, sact 
behaves as though each file in the directory were specified as a named file, except 
that non-SCCS files and unreadable files are silently ignored. If a name of - is given, 
the standard input is read with each line being taken as the name of an SCCS file to be 
processed. 

The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SID of a delta that currently exists in the SCCS file to 

which changes will be made to make the new delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will make the delta (i.e., 

executed a get for editing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

delta(l),get(l),unget(l). 

Use help(l) for explanations. 
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SAR(1) SAR(1) 

NAME 

sar - system activity reporter 

SYNOPSIS 

sar [-ubdycwaqvmprA] [-o file] t [ n ] 

sar [-ubdycwaqvmprA] [-s time][-e time] [-4 sec] [-f file] 

DESCRIPTION 

sar, in the first instance, samples cumulative activity counters in the operating system 
at n intervals of t seconds, where t should be 5 or greater. If the -o option is 
specified, it saves the samples in file in binary format. The default value of n is 1. In 
the second instance, with no sampling interval specified, sar extracts data from a pre- 
viously recorded file, either the one specified by -f option or, by default, the standard 
system activity daily data file /usr/adm/sa/sadd for the current day dd. The starting 
and ending times of the report can be bounded via the -s and -e time arguments of 
the form hh[:mm[:ss]]. The -i option selects records at sec second intervals. Other- 
wise, all intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option: 

~u Report CPU utilization (the default): 

%usr, %sys, %wio, %idle - portion of time running in user mode, running in 
system mode, idle with some process waiting for block I/O, and otherwise idle. 
When used with -D, %sys is split into percent of time servicing requests from 
remote machines (%sys remote) and all other system time (%sys local). 

-b Report buffer activity: 

bread /s, bwrit/s - transfers per second of data between system buffers and 

disk or other block devices; 

Iread/s, lwrit/s - accesses of system buffers; 

%rcache, %wcache - cache hit ratios, i. e., (1-bread/lread) as a percentage; 

pread/s, pwrit/s - transfers via raw (physical) device mechanism. 

-d Report activity for each block device, e. g., disk or tape drive. When data is 
displayed, the device specification dsk- is generally used to represent a disk 
drive. The device specification used to represent a tape drive is machine 
dependent. The activity data reported is: 

%busy, avque - portion of time device was busy servicing a transfer request, 
average number of requests outstanding during that time; 
r+w/s, blks/s - number of data transfers from or to device, number of bytes 
transferred in 512-byte units; 

avwait, avserv - average time in ms. that transfer requests wait idly on queue, 
and average time to be serviced (which for disks includes seek, rotational 
latency and data transfer times). 

-y Report TTY device activity: 

rawch/s, canch/s, outch/s - input character rate, input character rate pro- 
cessed by canon, output character rate; 
rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem interrupt rates. 

-c Report system calls: 

scall/s - system calls of all types; 

sread/s, swrit/s, fork/s, exec/s - specific system calls; 

rchar/s, wchar/s - characters transferred by read and write system calls. 

When used with -D, the system calls are split into incoming, outgoing, and 

strictly local calls. 
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SAR(1) 



EXAMPLES 



FILES 



SEE ALSO 



-w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswot/s - number of transfers and number of 
512-byte units transferred for swapins and swapouts (including initial loading 
of some programs); 
pswch/s - process switches. 

-a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

-q Report average queue length while occupied, and % of time occupied: 
runq-sz, %runocc - run queue of processes in memory and runnable; 
swpq-sz, %swpocc - swap queue of processes swapped out but ready to run. 

-v Report status of process, i-node, file tables: 

text-sz, proc-sz, inod-sz, file-sz, lock-sz - entries/ size for each table, evaluated 

once at sampling point; 

ov - overflows that occur between sampling points for each table. 

-m Report message and semaphore activities: 
msg/s, sema/s - primitives per second. 

-p Report paging activities: 

vflt/s - address translation page faults (valid page not in memory); 

pflt/s - page faults from protection errors (illegal access to page) or "copy-on- 

writes"; 

pgfil/s - vflt/s satisfied by page-in from file system; 

rclm/s - valid pages reclaimed for free list. 

-r Report unused memory pages and disk blocks: 

freemem - average pages available to user processes; 
freeswap - disk blocks available for process swapping. 

-A Report all data. Equivalent to -udqbwcayvmpr. 

To see today's CPU activity so far: 

sar 
To watch CPU activity evolve for 10 minutes and save data: 

sar -o temp 60 10 
To later review disk and tape activity from that period: 

sar -d -f temp 

/usr/adm/sa/sadd 

daily data file, where dd are digits representing the day of the 
month. 

sar(lM) 
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SAR(TM) 

NAME 
SYNOPSIS 



DESCRIPTION 



SAR(1M) 



sal, sa2, sadc - system activity report package 

/usr/lib/sa/sadc [t n] [ofile] 

/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvmprSDA] [-s time] [-e time] [-i sec] 

System activity data can be accessed at the special request of a user (see sar(D) and 
automatically on a routine basis as described here. The operating system contains a 
number of counters that are incremented as various system actions occur. These 
include counters for CPU utilization, buffer usage, disk and tape I/O activity, TTY 
device activity, switching and system-call activity, file-access, queue activity, inter- 
process communications, paging and Remote File Sharing. 

Sadc and shell procedures, sal and sal, are used to sample, save, and process this 
data. 

Sadc, the data collector, samples system data n times every t seconds and writes in 
binary format to ofile or to standard output. If t and n are omitted, a special record is 
written. This facility is used at system boot time, when booting to a multiuser state, 
to mark the time at which the counters restart from zero. For example, the 
/etc/init.d/perf file writes the restart mark to the daily data by the command entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sa v date +%d v " 

The shell script sal, a variant of sadc, is used to collect and store data in binary file 
/usr/adm/sa/sadd where dd is the current day. The arguments t and n cause records 
to be written n times at an interval of t seconds, or once if omitted. The entries in 
/usr/spool/cron/crontabs/sys (see cron (1M)): 

0***0-6 /usr/lib/sa/sal 

20,40 8-17 * * 1-5 /usr/lib/sa/sal 

will produce records every 20 minutes during working hours and hourly otherwise. 

The shell script sal, a variant of sar{\), writes a daily report in file /usr/adm/sa/sardd. 
The options are explained in sard). The /usr/spool/cron/crontabs/sys entry: 

5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 

will report important activities hourly during the working day. 

The structure of the binary daily data file is: 

struct sa { 

struct sysinfo si; /* see /usr/include/sys/sysinfo.h */ 

struct minfo mi; /* defined in sys/sysinfo.h */ 

struck dinfo di; /* RFS info defined in sys/sysinfo.h */ 

int minserve, maxserve; /* RFS server low and high water marks */ 

int szinode; /* current size of inode table */ 

int szfile; /* current size of file table */ 

int szproc; /* current size of proc table */ 

int szlckf; /* current size of file record header table */ 

int szlckr; /* current size of file record lock table */ 

int mszinode; /* size of inode table */ 

int mszfile; /* size of file table */ 
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SAR(1M) 



FILES 



SEE ALSO 



int mszproc; 

int mszlckf; 

int mszlckr; 

long inodeovf; 

long fileovf; 

long procovf; 

time_t ts; 

long devio[NDEVS][4]; 
#define IO_OPS 
#define IOJ3CNT 
#define IO_ACT 
#define IO_RESP 

}; 

/usr/adm/sa/sadd 

/usr/adm/sa/sardd 

/tmp/sa.adrfl 



/* size of proc table */ 

/* maximum size of file record header table */ 
/* maximum size of file record lock table */ 
/* cumulative overflows of inode table */ 
/* cumulative overflows of file table */ 
/* cumulative overflows of proc table */ 
/* time stamp, seconds */ 

/* device unit information */ 

/* cumulative I/O requests */ 

1 / * cumulative blocks transferred * / 

2 / * cumulative drive busy time in ticks * / 

3 / * cumulative I/O resp time in ticks * / 



daily data file 
daily report file 
address file 



cron(lM), sag(lG), sar(l), timex(l). 
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NAME 

SYNOPSIS 

DESCRIPTION 



SCCS(1) 



sees - front end for the SCCS subsystem 

sees [ -r ] [ -dpath ] [ -ppath ] command [ flags ] [ args ] 

Sees is a front end to the SCCS programs that helps them mesh more cleanly with the 
rest of UNIX. It also includes the capability to run "set user id" to another user to 
provide additional protection. 

Basically, sees runs the command with the specified flags and args. Each argument is 
normally modified to be prepended with "SCCS/s". 

Flags to be interpreted by the sees program must be before the command argument. 
Flags to be passed to the actual SCCS program must come after the command 
argument. These flags are specific to the command and are discussed in the 
documentation for that command. 

Besides the usual SCCS commands, several "pseudo-commands" can be issued. 
These are: 

edit Equivalent to "get -e". 

delget Perform a delta on the named files and then get new versions. The 

new versions will have id keywords expanded, and will not be 
editable. The -m, -p, -r, -s, and -y flags will be passed to delta, and 
the -b, -c, -e, -i, -k, -1, -s, and -x flags will be passed to get. 

deledit Equivalent to "delget" except that the "get" phase includes the "-e" 

flag. This option is useful for making a "checkpoint" of your current 
editing phase. The same flags will be passed to delta as described 
above, and all the flags listed for "get" above except -e and -k are 
passed to "edit". 

create Creates an SCCS file, taking the initial contents from the file of the 

same name. Any flags to "admin" are accepted. If the creation is 
successful, the files are renamed with a comma on the front. These 
should be removed when you are convinced that the SCCS files have 
been created successfully. 

fix Must be followed by a -r flag. This command essentially removes 

the named delta, but leaves you with a copy of the delta with the 
changes that were in it. It is useful for fixing small compiler bugs, 
etc. Since it doesn't leave audit trails, it should be used carefully. 

clean This routine removes everything from the current directory that can 

be recreated from SCCS files. It will not remove any files being 
edited. If the -b flag is given, branches are ignored in the 
determination of whether they are being edited; this is dangerous if 
you are keeping the branches in the same directory. 

unedit This is the opposite of an "edit" or a "get -e". It should be used 

with extreme caution, since any changes you made since the get will 
be irretrievably lost. 

info Gives a listing of all files being edited. If the -b flag is given, 

branches (i.e., SID's with two or fewer components) are ignored. If 
the -u flag is given (with an optional argument) then only files being 
edited by you (or the named user) are listed. 
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check Like "info" except that nothing is printed if nothing is being edited, 

and a non-zero exit status is returned if anything is being edited. 
The intent is to have this included in an "install" entry in a makefile 
to insure that everything is included into the SCCS file before a 
version is installed. 

tell Gives a newline-separated list of the files being edited on the 

standard output. Takes the -b and -u flags like "info" and "check". 

diffs Gives a "diff" listing between the current version of the program(s) 

you have out for editing and the versions in SCCS format. The -r, -c, 
-i, -x, and -t flags are passed to get; the -1, -s, -e, -f, -h, and -b 
options are passed to diff. The -C flag is passed to diff as -c. 

print This command prints out verbose information about the named files. 

The -r flag runs sees as the real user rather than as whatever effective user sees is "set 
user id" to. The -d flag gives a root directory for the SCCS files. The default is the 
current directory. The -p flag defines the pathname of the directory in which the 
SCCS files will be found; "SCCS" is the default. The -p flag differs from the -d flag in 
that the -d argument is prepended to the entire pathname and the -p argument is 
inserted before the final component of the pathname. For example, "sees -d/x -py 
get a/b" will convert to "get /x/a/y/s.b". The intent here is to create aliases such as 
"alias syssccs sees -d/usr/src" which will be used as "syssccs get cmd/who.c". 
Also, if the environment variable PROJECT is set, its value is used to determine the 
-d flag. If it begins with a slash, it is taken directly; otherwise, the home directory of a 
user of that name is examined for a subdirectory "sre" or "source". If such a 
directory is found, it is used. 

Certain commands (such as admin) cannot be run "set user id" by all users, since this 
would allow anyone to change the authorizations. These commands are always run 
as the real user. 

EXAMPLES 

To get a file for editing, edit it, and produce a new delta: 

sees get -e file.c 

ex file.c 

sees delta file.c 

To get a file from another directory: 

sccs-p/usr/src/sccs/s. get cc.c 
or 

sees get /usr/src/sccs/s.cc.c 
To make a delta of a large number of files in the current directory: 

sees delta *.c 
To get a list of files being edited that are not on branches: 

sees info -b 
To delta everything being edited by you: 

sees delta s sccs tell -u 

In a makefile, to get source files from an SCCS file if it does not already exist: 

SRCS = <list of source files> 
$(SRCS): 

sees get $(REL) $@ 
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SEE ALSO 

admin(SCCS), chghist(SCCS), comb(SCCS), delta(SCCS), get(SCCS), help(SCCS), 

prt(SCCS), rmdel(SCCS), sccsdiff (SCCS), what(SCCS) 

Eric Allman, An Introduction to the Source Code Control System 

BUGS 

It should be able to take directory arguments on pseudo-commands like the SCCS 
commands do. 
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SCCSDIFF(-I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



sccsdif f - compare two versions of an SCCS file 

sccsdif f -rSIDl ~rSID2 [-p] [-sn] files 

sccsdiff compares two versions of an SCCS file and generates the differences between 
the two versions. Any number of SCCS files may be specified, but arguments apply 
to all files. 

-iSID? SIDl and SID2 specify the deltas of an SCCS file that are to be 

compared. Versions are passed to bdiffd) in the order given. 

-p pipe output for each file through pr(l). 

-sn n is the file segment size that bdiff will pass to diffd). This is 

useful when diff fails due to a high system load. 

/tmp/get????? Temporary files 

bdiff(l),get(l),help(l),pr(l). 

"file: No differences" If the two versions are the same. 

Use help(l) for explanations. 
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SCREENDUMP(I) 

NAME 

SYNOPSIS 

DESCRIPTION 



WARNING 
SEE ALSO 



SCREENDUMP (1) 



screendump - dump the screen display 

screendump [ -n ] 

screendump captures the display and outputs an image file to standard output. This 
image file may be output to the Tektronix printer through the IpiX) command using 
printer "TEK". 

screendump knows all about pseudo and true color and double buffer windows, and 
captures the screen as it appears to the user. Use xwd{\) to capture an individual 
window. 

By default, screendump compresses the output image using a simple run-length 
encoding scheme. This compression may be suppressed with the -n switch. 

An uncompressed screendump is nearly 4 megabytes large. 

lp(l),xwd(l) 
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NAME 

SYNOPSIS 

DESCRIPTION 



script - make typescript of terminal session 
script [ -a ] [ file ] 



Script makes a typescript of everything printed on your terminal. The typescript is 
written to file, or appended to file if the -a option is given. It can be sent to the line 
printer later with Ipr. If no file name is given, the typescript is saved in the file 
typescript. 

The script ends when the forked shell exits. 

This program is useful when using a crt and a hard-copy record of the dialog is 
desired, as for a student handing in a program that was developed on a crt when 
hard-copy terminals are in short supply. 

BUGS 

Script places everything in the log file. This is not what the naive user expects. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SD!FF(1) 



sdiff - side-by-side difference program 

sdiff [ options ... ] filel file2 

sdiff uses the output of diffd) to produce a side-by-side listing of two files indicating 
those lines that are different. Each line of the two files is printed with a blank gutter 
between them if the lines are identical, a < in the gutter if the line only exists in filel , 
a > in the gutter if the line only exists in filel, and a I for lines that are different. 

For example: 



I 

< 
< 



y 

a 



d 
c 



SEE ALSO 



x 
a 
b 
c 
d 

The following options exist: 

-w n Use the next argument, n, as the width of the output line. The default 

line length is 130 characters. 

-1 Only print the left side of any lines that are identical. 

-s Do not print identical lines. 

-o output Use the next argument, output, as the name of a third file that is created 
as a user-controlled merging of filel and filel. Identical lines of filel and 
filel are copied to output. Sets of differences, as produced by diff(l), are 
printed; where a set of differences share a common gutter character. 
After printing each set of differences, sdiff prompts the user with a % 
and waits for one of the following user-typed commands: 

1 append the left column to the output file 

r append the right column to the output file 

s turn on silent mode; do not print identical lines 

v turn off silent mode 

e 1 call the editor with the left column 

e r call the editor with the right column 

e b call the editor with the concatenation of left and right 

e call the editor with a zero length file 

q exit from the program 

On exit from the editor, the resulting file is concatenated on the end of 
the output file. 

diffd), ed(l). 
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NAME 

SYNOPSIS 

DESCRIPTION 



SED(1) 



sed - stream editor 

sed [ ~n ] [ -e script ] [ -f sfile ] [ files ] 

sed copies the named files (standard input default) to the standard output, edited 
according to a script of commands. The -f option causes the script to be taken from 
file sfile; these options accumulate. If there is just one -e option and no -f options, 
the flag -e may be omitted. The -n option suppresses the default output. A script 
consists of editing commands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern space (unless 
there is something left after a D command), applies in sequence all commands whose 
addresses select that pattern space, and at the end of the script copies the pattern 
space to the standard output (except under -n) and deletes the pattern space. 

Some of the commands use a hold space to save all or part of the pattern space for sub- 
sequent retrieval. 

An address is either a decimal number that counts input lines cumulatively across 
files, a $ that addresses the last line of input, or a context address, i.e., a /regular 
expression/ in the style of ed{\) modified thus: 

In a context address, the construction \1 regular expression! , where ? is any 
character, is identical to /regular expression/. Note that in the context 
address \xabc\xdefx, the second x stands for itself, so that the regular 
expression is abcxdef . 

The escape sequence \n matches a new-line embedded in the pattern space. 

A period . matches any character except the terminal new-line of the pattern 
space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the 
address. 

A command line with two addresses selects the inclusive range from the first 
pattern space that matches the first address through the next pattern 
space that matches the second. (If the second address is a number less 
than or equal to the line number first selected, only one line is selected.) 
Thereafter the process is repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the 
negation function ! (below). 

In the following list of functions the maximum number of permissible addresses for 
each function is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of which end with \ 
to hide the new-line. Backslashes in text are treated like backslashes in the replace- 
ment string of an s command, and may be used to protect initial blanks and tabs 
against the stripping that is done on every script line. The rfile or wfile argument 
must terminate the command line and must be preceded by exactly one blank. Each 
wfile is created before processing begins. There can be at most 10 distinct wfile argu- 
ments. 



(l)a\ 
text 



Append. Place text on the output before reading the next input line. 



Stardent 1500/3000 



385 



Essential Utilities 



SED(1) SED(1) 

(2)1> label Branch to the : command bearing the label. If label is empty, branch to the I 

end of the script. 
(2)c\ 
text Change. Delete the pattern space. With or 1 address or at the end of a 

2-address range, place text on the output. Start the next cycle. 
(2) d Delete the pattern space. Start the next cycle. 

(2) D Delete the initial segment of the pattern space through the first new-line. 

Start the next cycle. 
(2)g Replace the contents of the pattern space by the contents of the hold 

space. 
(2) G Append the contents of the hold space to the pattern space. 

(2)h Replace the contents of the hold space by the contents of the pattern 

space. 
(2) H Append the contents of the pattern space to the hold space. 

(Di\ 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an unambiguous form. 

Non-printing characters are spelled in two-digit ASCII and long lines are 

folded. 
(2)n Copy the pattern space to the standard output. Replace the pattern space 

with the next line of input. 
(2)N Append the next line of input to the pattern space with an embedded 

new-line. (The current line number changes.) 
(2) p Print. Copy the pattern space to the standard output. 

(2) F Copy the initial segment of the pattern space through the first new-line to 



the standard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 
(2)rrfile Read the contents of rfile. Place them on the output before reading the 

next input line. 

(2) s/ regular expression /replacement /flags 

Substitute the replacement string for instances of the regular expression in 
the pattern space. Any character may be used instead of /. For a fuller 
description see ed(l). Flags is zero or more of: 

n n= 1 - 512. Substitute for just the n th occurrence of the regular 

expression. 
g Global. Substitute for all nonoverlapping instances of the reg- 
ular expression rather than just the first one. 
p Print the pattern space if a replacement was made, 
w wfile 

Write. Append the pattern space to wfile if a replacement was 
made. 
(2) t label Test. Branch to the : command bearing the label if any substitutions have 
been made since the most recent reading of an input line or execution of a 
t. If label is empty, branch to the end of the script. 
(2) ww file Write. Append the pattern space to wfile. 
(2) x Exchange the contents of the pattern and hold spaces. 

(2) y/stringl /string! / 

Transform. Replace all occurrences of characters in stringl with the 
corresponding character in string!. The lengths of stringl and string! 
must be equal. 
(2)! function 

Don't. Apply the function (or group, if function is {) only to lines not 
selected by the address(es). 
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(0) : label This command does nothing; it bears a label for b and t commands to 
branch to. 

(1) = Place the current line number on the standard output as a line. 

(2){ Execute the following commands through a matching } only when the 

pattern space is selected. 

(0) An empty command is ignored. 

(0) # If a # appears as the first character on the first line of a script file, then that 

entire line is treated as a comment, with one exception. If the character 
after the # is an 'n', then the default output will be suppressed. The rest 
of the line after #n is also ignored. A script file must contain at least one 
non-comment line. 

SEE ALSO 

awk(l), ed(l), grep(l). 
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NAME 

setmnt - establish mount table 

SYNOPSIS 

/etc/setmnt 

DESCRIPTION 

setmnt creates the /etc/mnttab table which is needed for both the mountdM) and 
umount commands, setmnt reads standard input and creates a mnttab entry for each 
line. Input lines have the format: 

filesys node 

where filesys is the name of the file system's special file (e.g., /dev/dsk/c?d?s?) and 
node is the root name of that file system. Thus filesys and node become the first two 
strings in the mount table entry. 



( 



FILES 
SEE ALSO 
BUGS 



/etc/mnttab 

mount(lM). 

Problems may occur if filesys or node are longer than 32 characters. 

setmnt silently enforces an upper limit on the maximum number of mnttab entries. 
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NAME 
SYNOPSIS 

DESCRIPTION 



Definitions 



Commands 



SH(1) 



sh, rsh - shell, the standard/restricted command programming language 

sh [ -acef hiknrstuvx ] [ args ] 
/lib/rsh [ -acef hiknrstuvx ] [ args ] 

sh is a command programming language that executes commands read from a termi- 
nal or a file, rsh is a restricted version of the standard command interpreter sh; it is 
used to set up login names and execution environments whose capabilities are more 
controlled than those of the standard shell. See "Invocation" below for the meaning 
of arguments to the shell. 

A blank is a tab or a space. A name is a sequence of letters, digits, or underscores 
beginning with a letter or underscore. A parameter is a name, a digit, or any of the 
characters *, @, #, ?, -, $, and !. 

A simple-command is a sequence of non-blank words separated by blanks . The first 
word specifies the name of the command to be executed. Except as specified below, 
the remaining words are passed as arguments to the invoked command. The com- 
mand name is passed as argument (see exec (2)). The value of a simple-command is its 
exit status if it terminates normally, or (octal) 200+status if it terminates abnormally 
(see signal(2) for a list of status values). 

A pipeline is a sequence of one or more commands separated by I . The standard out- 
put of each command but the last is connected by a pipe(2) to the standard input of 
the next command. Each command is run as a separate process; the shell waits for 
the last command to terminate. The exit status of a pipeline is the exit status of the 
last command. 

A list is a sequence of one or more pipelines separated by ;, &, &&, or I I, and 
optionally terminated by ; or &. Of these four symbols, ; and & have equal pre- 
cedence, which is lower than that of && and I I . The symbols && and I I also have 
equal precedence. A semicolon (;) causes sequential execution of the preceding pipe- 
line; an ampersand (&) causes asynchronous execution of the preceding pipeline (i.e., 
the shell does not wait for that pipeline to finish). The symbol && (T I) causes the 
list following it to be executed only if the preceding pipeline returns a zero (non- 
zero) exit status. An arbitrary number of new-lines may appear in a list, instead of 
semicolons, to delimit commands. 

A command is either a simple-command or one of the following. Unless otherwise 
stated, the value returned by a command is that of the last simple-command executed 
in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next word taken from 
the in word list. If in word ... is omitted, then the for command executes the do 
list once for each positional parameter that is set (see Parameter Substitution 
below). Execution ends when there are no more words in the list. 

case word in [ pattern [ I pattern ] . . . ) list ;; ] . . . esac 

A case command executes the list associated with the first pattern that matches 
word. The form of the patterns is the same as that used for file-name generation 
(see "File Name Generation") except that a slash, a leading dot, or a dot 
immediately following a slash need not be matched explicitly. 
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if list then list [ elif list then list ] . . . [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, the list fol- 
lowing the first then is executed. Otherwise, the list following elif is executed 
and, if its value is zero, the list following the next then is executed. Failing that, 
the else list is executed. If no else list or then list is executed, then the if com- 
mand returns a zero exit status. 

while list do list done 

A while command repeatedly executes the while list and, if the exit status of 
the last command in the list is zero, executes the do list; otherwise the loop ter- 
minates. If no commands in the do list are executed, then the while command 
returns a zero exit status; until may be used in place of while to negate the loop 
termination test. 



Execute list in a sub-shell. 



(list) 

{list} 

list is executed in the current (that is, parent) shell. 

name {list*} 

Define a function which is referenced by name. The body of the function is the 
list of commands between { and }. Execution of functions is described below 
(see Execution ). 

The following words are only recognized as the first word of a command and when 
not quoted: 

if then else elif fi case esac for while until do done { } 



( 



Comments 

A word beginning with # causes that word and all the following characters up to a 
new-line to be ignored. 

Command Substitution 

The shell reads commands from the string between two grave accents ( %v ) and the 
standard output from these commands may be used as all or part of a word. Trailing 
new-lines from the standard output are removed. 

No interpretation is done on the string before the string is read, except to remove 
backslashes (\) used to escape other characters. Backslashes may be used to escape a 
grave accent ( K ) or another backslash (\) and are removed before the command 
string is read. Escaping grave accents allows nested command substitution. If the 
command substitution lies within a pair of double quotes (" ... x ... v ... "), a backslash 
used to escape a double quote ( Y f ) will be removed; otherwise, it will be left intact. 

If a backslash is used to escape a new-line character (\new-line), both the backslash 
and the new-line are removed (see the later section on "Quoting"). In addition, 
backslashes used to escape dollar signs (\$) are removed. Since no interpretation is 
done on the command string before it is read, inserting a backslash to escape a dollar 
sign has no effect. Backslashes that precede characters other than \, v , ", new-line, 
and $ are left intact when the command string is read. 

Parameter Substitution 

The character $ is used to introduce substitutable parameters . There are two types of 
parameters, positional and keyword. If parameter is a digit, it is a positional parame- 
ter. Positional parameters may be assigned values by set. Keyword parameters (also 
known as variables) may be assigned values by writing: 

name-value [ name-value ] ... 
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Pattern-matching is not performed on value. There cannot be a function and a vari- 
able with the same name . 

%{parameter] 

The value, if any, of the parameter is substituted. The braces are required only 
when parameter is followed by a letter, digit, or underscore that is not to be 
interpreted as part of its name. If parameter is * or @, all the positional parame- 
ters, starting with $1, are substituted (separated by spaces). Parameter $0 is set 
from argument zero when the shell is invoked. 

§{parameter\-word) 

If parameter is set and is non-null, substitute its value; otherwise substitute 
word. 

${parameter:=word} 

If parameter is not set or is null set it to word; the value of the parameter is sub- 
stituted. Positional parameters may not be assigned to in this way. 

${parameter:?word} 

If parameter is set and is non-null, substitute its value; otherwise, print word and 
exit from the shell. If word is omitted, the message "parameter null or not set" 
is printed. 

${parameter:+word] 

If parameter is set and is non-null, substitute word; otherwise substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substituted string, so 
that, in the following example, pwd is executed only if d is not set or is null: 

echo ${d:- v pwd N } 
If the colon (:) is omitted from the above expressions, the shell only checks whether 
parameter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

- Flags supplied to the shell on invocation or by the set command. 

? The decimal value returned by the last synchronously executed com- 
mand. 

$ The process number of this shell. 

! The process number of the last background command invoked. 
The following parameters are used by the shell: 

HOME 

The default argument (home directory) for the cd command. 

PATH 

The search path for commands (see Execution below). The user may not 
change PATH if executing under rsh. 

CDPATH 

The search path for the cd command. 

MAIL 

If this parameter is set to the name of a mail file and the MAILPATH 
parameter is not set, the shell informs the user of the arrival of mail in the 
specified file. 

MAILCHECK 

This parameter specifies how often (in seconds) the shell will check for the 
arrival of mail in the files specified by the MAILPATH or MAIL parame- 
ters. The default value is 600 seconds (10 minutes). If set to 0, the shell 
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will check before each prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set, the shell 
informs the user of the arrival of mail in any of the specified files. Each 
file name can be followed by % and a message that will be printed when 
the modification time changes. The default message is you have mail . 

PS1 Primary prompt string, by default "$ ". 

PS2 Secondary prompt string, by default "> ". 

IFS Internal field separators, normally space, tab, and new-line. 

SHACCT 

If this parameter is set to the name of a file writable by the user, the shell 
will write an accounting record in the file for each shell procedure exe- 
cuted. 

SHELL 

When the shell is invoked, it scans the environment (see "Environment" 
below) for this name. If it is found and 'rsh' is the file name part of its 
value, the shell becomes a restricted shell. 

The shell gives default values to PATH, PS1, PS2, MAILCHECK and IFS. HOME and 
MAIL are set by login{\). 

Blank Interpretation 

After parameter and command substitution, the results of substitution are scanned 
for internal field separator characters (those found in IFS) and split into distinct argu- 
ments where^sijududbaracters are-found^PiX-plirit--Piill-arguTneiits ("". or ".) are 
retained. Implicit null arguments (those resulting from parameters that have no 
values) are removed. 

A command's input and output may be redirected using a special notation inter- 
preted by the shell. The following may appear anywhere in a simple-command or may 
precede or follow a command and are not passed on as arguments to the invoked 
command. Note that parameter and command substitution occurs before word or 
digit is used. 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). If the file does 

not exist it is created; otherwise, it is truncated to zero length. 

»word Use file word as standard output. If the file exists output is appended 

to it (by first seeking to the end-of-file); otherwise, the file is created. 

«[-]word After parameter and command substitution is done on word, the shell 
input is read up to the first line that literally matches the resulting 
word, or to an end-of-file. If, however, - is appended to «: 

1) leading tabs are stripped from word before the shell input is read 
(but after parameter and command substitution is done on 
word), 

2) leading tabs are stripped from the shell input as it is read and 
before each line is compared with word, and 

3) shell input is read up to the first line that literally matches the 
resulting word, or to an end-of-file. 

If any character of word is quoted (see "Quoting," later), no additional 
processing is done to the shell input. If no characters of word are 
quoted: 
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1) parameter and command substitution occurs, 

2) (escaped) \new-line is ignored, and 

3) \ must be used to quote the characters \, $, and v . 

The resulting document becomes the standard input. 

<&digit Use the file associated with file descriptor digit as standard input. 

Similarly for the standard output using >&digit. 

<&^ The standard input is closed. Similarly for the standard output using 

If any of the above is preceded by a digit, the file descriptor which will be associated 
with the file is that specified by the digit (instead of the default or 1). For example: 

...2>&1 

associates file descriptor 2 with the file currently associated with file descriptor 1. 

The order in which redirections are specified is significant. The shell evaluates 
redirections left-to-right. For example: 

... 1>xxx2>&1 

first associates file descriptor 1 with file xxx . It associates file descriptor 2 with the 
file associated with file descriptor 1 (i.e., xxx). If the order of redirections were 
reversed, file descriptor 2 would be associated with the terminal (assuming file 
descriptor 1 had been) and file descriptor 1 would be associated with file xxx . 

Using the terminology introduced on the first page, under "Commands," if a com- 
mand is composed of several simple commands, redirection will be evaluated for the 
entire command before it is evaluated for each simple command. That is, the shell 
evaluates redirection for the entire list, then each pipeline within the list, then each 
command within each pipeline, then each list within each command. 

If a command is followed by & the default standard input for the command is the 
empty file /dev/null. Otherwise, the environment for the execution of a command 
contains the file descriptors of the invoking shell as modified by input/ output 
specifications. 

Redirection of output is not allowed in the restricted shell. 

File Name Generation 

Before a command is executed, each command word is scanned for the characters *, ?, 
and [ . If one of these characters appears the word is regarded as a pattern. The word 
is replaced with alphabetically sorted file names that match the pattern. If no file 
name is found that matches the pattern, the word is left unchanged. The character . 
at the start of a file name or immediately following a /, as well as the character / itself, 
must be matched explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[...] Matches any one of the enclosed characters. A pair of characters 
separated by - matches any character lexically between the pair, inclusive. 
If the first character following the opening "[ " is a "!" any character not 
enclosed is matched. 



Quoting 



The following characters have a special meaning to the shell and cause termination of 
a word unless quoted: 
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& ( ) I A < > new-line space tab 



Prompting 



A character may be quoted (i.e., made to stand for itself) by preceding it with a 
backslash (\) or inserting it between a pair of quote marks ( ' ' or ""). During pro- 
cessing, the shell may quote certain characters to prevent them from taking on a spe- 
cial meaning. Backslashes used to quote a single character are removed from the 
word before the command is executed. The pair \new-line is removed from a word 
before command and parameter substitution. 

All characters enclosed between a pair of single quote marks ( ' '), except a single 
quote, are quoted by the shell. Backslash has no special meaning inside a pair of sin- 
gle quotes. A single quote may be quoted inside a pair of double quote marks (for 
example,"'"). 

Inside a pair of double quote marks (""), parameter and command substitution 
occurs and the shell quotes the results to avoid blank interpretation and file name 
generation. If $* is within a pair of double quotes, the positional parameters are sub- 
stituted and quoted, separated by quoted spaces ("$1 $2 . . ."); however, if $@ is 
within a pair of double quotes, the positional parameters are substituted and quoted, 
separated by unquoted spaces ("$1" "$2" . . . ). \ quotes the characters \, K , ", and $. 
The pair \new-line is removed before parameter and command substitution. If a 
backslash precedes characters other than \, v , ", $, and new-line, then the backslash 
itself is quoted by the shell. 

When used interactively, the shell prompts with the value of PS1 before reading a 
command. If at any time a new-line is typed and further input is needed to complete 
a command, the secondary prompt (i.e., the value of PS2) is issued. 

The environment (see environ(5)) is a list of name- value pairs that is passed to an exe- 
cuted program in the same way as a normal argument list. The shell interacts with 
the environment in several ways. On invocation, the shell scans the environment and 
creates a parameter for each name found, giving it the corresponding value. If the 
user modifies the value of any of these parameters or creates new parameters, none 
of these affects the environment unless the export command is used to bind the 
shell's parameter to the environment (see also set -a). A parameter may be removed 
from the environment with the unset command. The environment seen by any exe- 
cuted command is thus composed of any unmodified name-value pairs originally 
inherited by the shell, minus any pairs removed by unset, plus any modifications or 
additions, all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one 
or more assignments to parameters. Thus: 

TERM=450 cmd 

and 
(export TERM; TERM=450; cmd) 

are equivalent (as far as the execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environment, even if 
they occur after the command name. In the following example, the first echo com- 
mand prints a=b c; after the set command is issued, the second echo command prints 
c: 

echo a=b c 
set -k 
echo a=b c 



c 
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Signals 

The INTERRUPT and QUIT signals for an invoked command are ignored if the com- 
mand is followed by &; otherwise signals have the values inherited by the shell from 
its parent, with the exception of signal 11 (but see also the trap command below). 

Execution 

Each time a command is executed, the above substitutions are carried out. If the 
command name matches one of the Special Commands listed below, it is executed in 
the shell process. If the command name does not match a Special Command, but 
matches the name of a defined function, the function is executed in the shell process 
(note how this differs from the execution of shell procedures). The positional param- 
eters $1, $2, are set to the arguments of the function. If the command name 

matches neither a Special Command nor the name of a defined function, a new process 
is created and an attempt is made to execute the command via exec (2). 

The shell parameter PATH defines the search path for the directory containing the 
command. Alternative directory names are separated by a colon (:). The default 
path is :/bin:/usr/bin (specifying the current directory, /bin, and /usr/bin, in that 
order). Note that the current directory is specified by a null path name, which can 
appear immediately after the equal sign, between two colon delimiters anywhere in 
the path list, or at the end of the path list. If the command name contains a / the 
search path is not used; such commands will not be executed by the restricted shell. 
Otherwise, each directory in the path is searched for an executable file. If the file has 
execute permission but is not an a.out file, it is assumed to be a file containing shell 
commands. A sub-shell is spawned to read it. A parenthesized command is also 
executed in a sub-shell. 

The location in the search path where a command was found is remembered by the 
shell (to help avoid unnecessary execs later). If the command was found in a relative 
directory, its location must be re-determined whenever the current directory 
changes. The shell forgets all remembered locations whenever the PATH variable is 
changed or the hash -r command is executed (see below). 

Special Commands 

Input/output redirection is now permitted for these commands. File descriptor 1 is 
the default output location. 

: No effect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands from file and return. The search path specified by 
PATH is used to find the directory containing file. 

break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified break n levels. 

continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n is specified 
resume at the n-th enclosing loop. 

cd [ arg ] 

Change the current directory to arg. The shell parameter HOME is the default 
arg. The shell parameter CDPATH defines the search path for the directory con- 
taining arg. Alternative directory names are separated by a colon (:). The 
default path is <null> (specifying the current directory). Note that the current 
directory is specified by a null path name, which can appear immediately after 
the equal sign or between the colon delimiters anywhere else in the path list. If 
arg begins with a / the search path is not used. Otherwise, each directory in the 
path is searched for arg. The cd command may not be executed by rsh. 
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echo [ arg . . . ] I 

Echo arguments. See echo(l) for usage and description. 

eval [ arg ... ] 

The arguments are read as input to the shell and the resulting command(s) exe- 
cuted. 

exec [ arg ... ] 

The command specified by the arguments is executed in place of this shell 
without creating a new process. Input/ output arguments may appear and, if 
no other arguments are given, cause the shell input/ output to be modified. 

exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is omitted the exit 
status is that of the last command executed (an end-of-file will also cause the 
shell to exit.) 

export [ name ... ] 

The given names are marked for automatic export to the environment of 
subsequently-executed commands. If no arguments are given, variable names 
that have been marked for export during the current shell's execution are listed. 
(Variable names exported from a parent shell are listed only if they have been 
exported again during the current shell's execution.) Function names are not 
exported. 

getopts 

Use in shell scripts to support command syntax standards (see intro{Vji); it 

parses positional parameters and checks for legal options. See getopts (1) for 

— — u sage-andrdeseriptio n. — ______ 



( 



hash [ -r ] [ name ... ] 

For each name, the location in the search path of the command specified by 
name is determined and remembered by the shell. The -r option causes the 
shell to forget all remembered locations. If no arguments are given, informa- 
tion about remembered commands is presented. Hits is the number of times a 
command has been invoked by the shell process. Cost is a measure of the work 
required to locate a command in the search path. If a command is found in a 
"relative" directory in the search path, after changing to that directory, the 
stored location of that command is recalculated. Commands for which this will 
be done are indicated by an asterisk (*) adjacent to the hits information. Cost 
will be incremented when the recalculation is done. 

newgrp [arg... ] 

Equivalent to exec newgrp arg .... See newgrpd) for usage and description. 

pwd Print the current working directory. See pwd(Y) for usage and description. 

read [ name ...o ] 

One line is read from the standard input and, using the internal field separator, 
IFS (normally space or tab), to delimit word boundaries, the first word is 
assigned to the first name, the second word to the second name, etc., with left- 
over words assigned to the last name. Lines can be continued using \new-line. 
Characters other than new-line can be quoted by preceding them with a 
backslash. These backslashes are removed before words are assigned to names, 
and no interpretation is done on the character that follows the backslash. The 
return code is unless an end-of-file is encountered. 

readonly [ name ... ] 

The given names are marked readonly and the values of the these names may not 

be changed by subsequent assignment. If no arguments are given, a list of all | 

readonly names is printed. ^ 
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return [ n ] 

Causes a function to exit with the return value specified by n. If n is omitted, 
the return status is that of the last command executed. 

set [ — aefhkntuvx [ arg . . . ] ] 

-a Mark variables which are modified or created for export. 
-e Exit immediately if a command exits with a non-zero exit status. 
-f Disable file name generation 

-h Locate and remember function commands as functions are defined (func- 
tion commands are normally located when the function is executed). 

-k All keyword arguments are placed in the environment for a command, 
not just those that precede the command name. 

-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-v Print shell input lines as they are read. 

-x Print commands and their arguments as they are executed. 

— Do not change any of the flags; useful in setting $1 to -. 

Using + rather than - causes these flags to be turned off. These flags can also be 
used upon invocation of the shell. The current set of flags may be found in $-. 
The remaining arguments are positional parameters and are assigned, in order, 
to $1, $2, . . . . If no arguments are given the values of all names are printed. 

shift [ n ] 

The positional parameters from $n+l ... are renamed $1 . . . . If n is not given, 
it is assumed to be 1. 

test 

Evaluate conditional expressions. See test(l) for usage and description. 

times 

Print the accumulated user and system times for processes run from the shell. 

trap [ arg ] [ n ] . . . 

The command arg is to be read and executed when the shell receives signal(s) 
n . (Note that arg is scanned once when the trap is set and once when the trap is 
taken.) Trap commands are executed in order of signal number. Any attempt 
to set a trap on a signal that was ignored on entry to the current shell is ineffec- 
tive. An attempt to trap on signal 11 (memory fault) produces an error. If arg 
is absent all trap(s) n are reset to their original values. If arg is the null string 
this signal is ignored by the shell and by the commands it invokes. If n is the 
command arg is executed on exit from the shell. The trap command with no 
arguments prints a list of commands associated with each signal number. 

type [ name . . . ] 

For each name, indicate how it would be interpreted if used as a command 
name. 

ulimit [ n ] 

Impose a size limit of n blocks on files written by the shell and its child 
processes (files of any size may be read). If n is omitted, the current limit is 
printed. You may lower your own ulimit, but only a super-user (see su(lM)) 
can raise a ulimit. 

umask[ nnn ] 

The user file-creation mask is set to nnn (see umask(D). If nnn is omitted, the 
current value of the mask is printed. 
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unset [ name ... ] 

For each name, remove the corresponding variable or function. The variables 
PATH, PS1, PS2, MAILCHECK and IFS cannot be unset. 

wait[ n ] 

Wait for your background process whose process id is n and report its termi- 
nation status. If n is omitted, all your shell's currently active background 
processes are waited for and the return code will be zero. 



Invocation 



If the shell is invoked through exec (2) and the first character of argument zero is -, 
commands are initially read from /etc/profile and from $HOME/. pro file, if such files 
exist. Thereafter, commands are read as described below, which is also the case 
when the shell is invoked as /bin/sh. The flags below are interpreted by the shell on 
invocation only; Note that unless the -c or -s flag is specified, the first argument is 
assumed to be the name of a file containing commands, and the remaining argu- 
ments are passed as positional parameters to that command file: 

-c string If the -c flag is present commands are read from string. 

-s If the -s flag is present or if no arguments remain commands are read 

from the standard input. Any remaining arguments specify the positional 
parameters. Shell output (except for Special Commands ) is written to file 
descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a 

terminal, this shell is interactive. In this case TERMINATE is ignored (so 

that kill does not kill an interactive shell) and INTERRUPT is caught and 



C 



rsh Only 



ignored (so that wait is interruptible). In all cases, QUIT is ignored by the 
shell. 

-r If the -r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set command above. 



( 



rsh is used to set up login names and execution environments whose capabilities are 
more controlled than those of the standard shell. The actions of rsh are identical to 
those of sh, except that the following are disallowed: 

changing directory (see cd (1 )), 

setting the value of $PATH, 

specifying path or command names containing /, 

redirecting output (> and »). 

The restrictions above are enforced after .profile is interpreted. 

A restricted shell can be invoked in one of the following ways: (1) rsh is the file name 
part of the last entry in the /etc/passxvd file (see passwdd)); (2) the environment vari- 
able SHELL exists and rsh is the file name part of its value; (3) the shell is invoked and 
rsh is the file name part of argument 0; (4) the shell is invoke with the -r option. 

When a command to be executed is found to be a shell procedure, rsh invokes sh to 
execute it. Thus, it is possible to provide to the end-user shell procedures that have 
access to the full power of the standard shell, while imposing a limited menu of com- 
mands; this scheme assumes that the end-user does not have write and execute per- 
missions in the same directory. 

The net effect of these rules is that the writer of the .profile (see profile^)) has complete 

control over user actions by performing guaranteed setup actions and leaving the ^ 

user in an appropriate directory (probably not the login directory). I 
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EXIT STATUS 



FILES 



SEE ALSO 



CAVEATS 



BUGS 



The system administrator often sets up a directory of commands (i.e., /usr/rbin) that 
can be safely invoked by a restricted shell. Some systems also provide a restricted 
editor, red. 

Errors detected by the shell, such as syntax errors, cause the shell to return a non- 
zero exit status. If the shell is being used non-interactively execution of the shell file 
is abandoned. Otherwise, the shell returns the exit status of the last command exe- 
cuted (see also the exit command above). 

/etc/profile 
$HOME/. profile 
/tmp/sh* 
/dev/null 

cd(l), dup(2), echo(l), env(l), exec(2), fork(2), getopts(l), intro(l), login(l), newgrp(l), 
pipe(2), profiled), pwd(l), signal(2), test(l), ulimit(2), umask(l), wait(l). 

Words used for filenames in input/output redirection are not interpreted for 
filename generation (see "File Name Generation/' above). For example, cat filel >a* 
will create a file named a*. 

Because commands in pipelines are run as separate processes, variables set in a pipe- 
line have no effect on the parent shell. 

If you get the error message cannot fork, too many processes , try using the wait (I) com- 
mand to clean up your background processes. If this doesn't help, the system pro- 
cess table is probably full or you have too many active foreground processes. (There 
is a limit to the number of process ids associated with your login, and to the number 
the system can keep track of.) 

If a command is executed, and a command with the same name is installed in a direc- 
tory in the search path before the directory where the original command was found, 
the shell will continue to exec the original command. Use the hash command to 
correct this situation. 

If you move the current directory or one above it, pwd may not give the correct 
response. Use the cd command with a full path name to correct this situation. 

Not all the processes of a 3- or more-stage pipeline are children of the shell, and thus 
cannot be waited for. 

For wait n, if n is not an active process id, all your shell's currently active background 
processes are waited for and the return code will be zero. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SHUTDOWN (TM) 



shutdown - shut down system, change system state 

/etc/shutdown [ -y ] [ -ggrace_period [ -iinit_state ] 

This command is executed by the super-user to change the state of the machine. By 
default, it brings the system to a state where only the console has access to the UNIX 
system. This state is traditionally called "single-user". 

The command sends a warning message and a final message before it starts actual 
shutdown activities. By default, the command asks for confirmation before it starts 
shutting down daemons and killing processes. The options are used as follows: 

-y pre-answers the confirmation question so the command can be run without 
user intervention. A default of 60 seconds is allowed between the warning 
message and the final message. Another 60 seconds is allowed between the 
final message and the confirmation. 

-ggracejperiod 

allows the super-user to change the number of seconds from the 60-second 
default. 

-iinit_state 

specifies the state that init(lM) is to be put in following the warnings, if any. 
By default, system state "s" is used (the same as states "1" and "S"). 

Other recommended system state definitions are: 



( 



FILES 
SEE ALSO 



state 

Shut the machine down so it is safe to remove the power. Have the machine 
remove power if it can. The /etc/rcO procedure is called to do this work. 

state 1, s, S 

Bring the machine to the state traditionally called single-user. The /etc/rcO pro- 
cedure is called to do this work. (Though s and 1 are both used to go to single 
user state, s only kills processes spawned by init and does not unmount file 
systems. State 1 unmounts everything except root and kills all user processes, 
except those that relate to the console.) 

state 5 

Stop the UNIX system and go to the firmware monitor. 

state 6 

Stop the UNIX system and reboot to the state defined by the initdefault entry in 
/etc/inittab. 

/etc/shutdown.d 

init(lM), inittab(4), rc0(8), rc2(8) 



c 
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NAME 



SYNOPSIS 
DESCRIPTION 



size - print section sizes in bytes of common object files 
size [-doxV] files 



The size command produces section size information in bytes for each loaded section 
in the common object files. The size of the text, data, and bss (uninitialized data) sec- 
tions is printed, as well as the sum of the sizes of these sections. If an archive file is 
input to the size command the information for all archive members is displayed. 

Numbers will be printed in decimal unless either the -o or the -x option is used, in 
which case they will be printed in octal or in hexadecimal, respectively. 

The -V flag will supply the version information on the size command. 

SEE ALSO 

as(l), cc(l), ld(l), a.out(4), ar(4). 

CAVEAT 

Since the size of bss sections is not known until link-edit time, the size command will 
not give the true total size of pre-linked objects. 
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SYNOPSIS 

DESCRIPTION 



SEE ALSO 



SLEEP (1) 



sleep - suspend execution for an interval 
sleep time 

sleep suspends execution for time seconds. It is used to execute a command after a 
certain amount of time, as in: 

(sleep 105; command)&: 

or to execute a command every so often, as in: 

while true 
do 

command 

sleep 37 
done 



( 



alarm(2), sleep(3C). 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



S0RT(1) 

sort - sort and/or merge files 

sort [-emu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnr] [-btx] [+posl [-pos2]] [files] 

sort sorts lines of all the named files together and writes the result on the standard 
output. The standard input is read if - is used as a file name or no input files are 
named. 

Comparisons are based on one or more sort keys extracted from each line of input. 
By default, there is one sort key, the entire input line, and ordering is lexicographic 
by bytes in machine collating sequence. 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering rules; give no out- 
put unless the file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal keys. 

-ooutput 

The argument given is the name of an output file to use instead of the standard 
output. This file may be the same as one of the inputs. There may be optional 
blanks between -o and output. 

-ykmem 

The amount of main memory used by the sort has a large impact on its perfor- 
mance. Sorting a small file in a large amount of memory is a waste. If this 
option is omitted, sort begins using a system default memory size, and contin- 
ues to use more space as needed. If this option is presented with a value, kmem, 
sort will start using that number of kilobytes of memory, unless the administra- 
tive minimum or maximum is violated, in which case the corresponding 
extremum will be used. Thus, -yO is guaranteed to start with minimum 
memory. By convention, -y (with no argument) starts with maximum memory. 

-zrecsz 

The size of the longest line read is recorded in the sort phase so buffers can be 
allocated during the merge phase. If the sort phase is omitted via the -c or -m 
options, a popular system default size will be used. Lines longer than the 
buffer size will cause sort to terminate abnormally. Supplying the actual 
number of bytes in the longest line to be merged (or some larger value) will 
prevent abnormal termination. 

The following options override the default ordering rules. 

-d "Dictionary'' order: only letters, digits and blanks (spaces and tabs) are 
significant in comparisons. 

-f Fold lower case letters into upper case. 

-i Ignore characters outside the ASCII range 040-0176 in non-numeric comparis- 
ons. 

-M Compare as months. The first three non-blank characters of the field are folded 
to upper case and compared so that "JAN" < "FEB" < . . . < "DEC". Invalid 
fields compare low to "JAN". The -M option implies the -b option (see below). 

-n An initial numeric string, consisting of optional blanks, optional minus sign, 
and zero or more digits with optional decimal point, is sorted by arithmetic 
value. The -n option implies the -b option (see below). Note that the -b 
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-r 



-Tdir 



option is only effective when restricted sort key specifications are in effect. 
Reverse the sense of comparisons. 

Air is the name of a directory in which temporary files should be created. 



When ordering options appear before restricted sort key specifications, the requested 
ordering rules are applied globally to all sort keys. When attached to a specific sort 
key (described below), the specified ordering options override all global ordering 
options for that key. 

The notation +posl -posl restricts a sort key to one beginning at posl and ending just 
before posl . The characters at position posl and just before posl are included in the 
sort key (provided that posl does not precede posl ). A missing -posl means the end 
of the line. 

Specifying posl and posl involves the notion of a field, a minimal sequence of charac- 
ters followed by a field separator or a new-line. By default, the first blank (space or 
tab) of a sequence of blanks acts as the field separator. All blanks in a sequence of 
blanks are considered to be part of the next field; for example, all blanks at the begin- 
ning of a line are considered to be part of the first field. The treatment of field 
separators can be altered using the options: 

-b Ignore leading blanks when determining the starting and ending positions of a 
restricted sort key. If the -b option is specified before the first +posl argument, 
it will be applied to all +posl arguments. Otherwise, the b flag may be attached 
independently to each +posl or -posl argument (see below). 



( 



EXAMPLES 



-tx Use x as the field separator character; x is not considered to be part of a field 
(although it may be included in a sort key). Each occurrence of x is significant 
(for example, xx delimits an empty field). 

Posl and posl each have the form rn.n optionally followed by one or more of the flags 
bdfinr. A starting position specified by +m.n is interpreted to mean the n+lst charac- 
ter in the ra+lst field. A missing m means .0, indicating the first character of the 
ra +lst field. If the b flag is in effect n is counted from the first non-blank in the ra +lst 
field; +ra.0b refers to the first non-blank character in the ra+lst field. 

A last position specified by -ra.n is interpreted to mean the nth character (including 
separators) after the last character of the m th field. A missing .n means .0, indicating 
the last character of the rath field. If the b flag is in effect n is counted from the last 
leading blank in the ra+lst field; -m.lb refers to the first non-blank in the ra+lst 
field. 

When there are multiple sort keys, later keys are compared only after all earlier keys 
compare equal. Lines that otherwise compare equal are ordered with all bytes 
significant. 

Sort the contents of infile with the second field as the sort key: 

sort +1-2 infile 

Sort, in reverse order, the contents of infilel and infilel, placing the output in outfile 
and using the first character of the second field as the sort key: 

sort -r -o outfile +1.0 -1.2 infilel infile2 

Sort, in reverse order, the contents of infilel and infilel using the first non-blank char- 
acter of the second field as the sort key: 



c 
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FILES 
SEE ALSO 
WARNINGS 



sort -r +1.0b -1.1b infilel infile2 

Print the password file (passwd(4)) sorted by the numeric user ID (the third colon- 
separated field): 

sort -t: +2n -3 /etc/passwd 

Print the lines of the already sorted file infile, suppressing all but the first occurrence 
of lines having the same third field (the options -um with just one input file make the 
choice of a unique representative from a set of equal lines predictable): 

sort -um +2 -3 infile 

/usr/tmp/stm??? 

comm(l), join(l), uniq(l). 

Comments and exits with non-zero status for various trouble conditions (for exam- 
ple, when input lines are too long), and for disorder discovered under the -c option. 
When the last line of an input file is missing a new-line character, sort appends one, 
prints a warning message, and continues. 

sort does not guarantee preservation of relative line ordering on equal keys. 
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NAME 
SYNOPSIS 



DESCRIPTION 



FILES 



SPELL(1) 



spell, hashmake, spellin, hashcheck - find spelling errors 

spell [ -v ] [ -b ] [ -x ] [ -1 ] [ +local_file ] [ files ] 
/usr/lib/spell/hashmake 
/usr/lib/spell/spellin n 
Vusr/lib/spell/hashcheck spelling_list 

spell collects words from the named files and looks them up in a spelling list. Words 
that neither occur among nor are derivable (by applying certain inflections, prefixes, 
and/or suffixes) from words in the spelling list are printed on the standard output. 
If no files are named, words are collected from the standard input. 

spell ignores most troffd), thl{l), and eqn(l) constructions. 

Under the -v option, all words not literally in the spelling list are printed, and plausi- 
ble derivations from the words in the spelling list are indicated. 

Under the -b option, British spelling is checked. Besides preferring centre, colour, 
programme, speciality, travelled, etc., this option insists upon -ise in words like standar- 
dise, Fowler and the OED to the contrary notwithstanding. 

Under the -x option, every plausible stem is printed with = for each word. 

By default, spell (like deroffd)) follows chains of included files (.so and .nx troffd) 
-i , equests)7-tmfegs^he-^tam es o f such inclu de d fil e s begirem th /usr/lib . U ^der the -1 



option, spell will follow the chains of all included files. 

Under the ^localjile option, words found in localjile are removed from spell's out- 
put. Localjile is the name of a user-provided file that contains a sorted list of words, 
one per line. With this option, the user can specify a set of words that are correct 
spellings (in addition to spell's own spelling list) for each job. 

The spelling list is based on many sources, and while more haphazard than an ordi- 
nary dictionary, is also more effective with respect to proper names and popular 
technical words. Coverage of the specialized vocabularies of biology, medicine, and 
chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated below with 

their default settings (see FILES). Copies of all output are accumulated in the history 

file. The stop list filters out misspellings (e.g., thier=thy-y+ier) that would otherwise 

pass. 

Three routines help maintain and check the hash lists used by spell: 

hashmake Reads a list of words from the standard input and writes the correspond- 
ing nine-digit hash code on the standard output. 

spellin Reads n hash codes from the standard input and writes a compressed 
spelling list on the standard output. 

hashcheck Reads a compressed spelling Jist and recreates the nine-digit hash codes 
for all the words in it; it writes these codes on the standard output. 



D_SPELL=/usr/lib/spell/hlist[ab] 

S_SPELL=/usr/lib/spell/hstop 

H_SPELL==/usr/lib/spell/spellhist 



hashed spelling lists, American & British 
hashed stop list 
history file 



( 



( 
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/usr/lib/spell/spellprog program 

SEE ALSO 

deroff(l), eqn(l), sed(l), sort(l), tbl(l), tee(l), troff(l). 

BUGS 

The spelling list's coverage is uneven; new installations will probably wish to moni- 
tor the output for several months to gather local additions; typically, these are kept in 
a separate local file that is added to the hashed spellingjist via spellin. 
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SPLIT(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



SPLIT(1) 



split - split a file into pieces 

split [ -n ] [ file [ name ] ] 

split reads file and writes it in n-line pieces (default 1000 lines) onto a set of output 
files. The name of the first output file is name with aa appended, and so on lexico- 
graphically, up to zz (a maximum of 676 files). Name cannot be longer than 12 char- 
acters. If no output name is given, x is default. 

If no input file is given, or if - is given in its stead, then the standard input file is 
used. 

bfs(l), csplit(l). 
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NAME 

SYNOPSIS 

DESCRIPTION 



strings - find the printable strings in an object, or other binary, file 
strings [ - ] [ -o ] [ -number ] file ... 



strings looks for ascii strings in a binary file. A string is any sequence of 4 or more 
printing characters ending with a newline or a null. Unless the - flag is given, strings 
only looks in the initialized data space of object files. If the -o flag is given, then each 
string is preceded by its offset in the file (in octal). If the -number flag is given then 
number is used as the minimum string length rather than 4. 

strings is useful for identifying random object files and many other things. 

SEE ALSO 

odd) 

BUGS 

The algorithm for identifying strings is extremely primitive. 
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NAME 

SYNOPSIS 

DESCRIPTION 



strip - strip symbol and line number information from a common object file 

strip [-1] [-x] [~b] [-r] [-V] filename ... 

The strip command renders debugging information in execu tables undecipherable by 
the debugger and by disassembler tools. This helps third-party software to be better 
protected from unfriendly users. Note that the Stardent 1500/3000 strip command 
does not completely remove this information, as do strip commands on most other 
systems. As a result, using strip does not result in a very large reduction of disk 
usage and is of little value to users who do not want protection against disassembly. 

Stardent strongly discourages users from using the strip command. One of the 
important tools provided by Stardent is a postloading capability. Among other things, 
the profiler, the -opct loader option, and the adapt(l) utility (which transforms Star- 
dent 1500 executables so that they will run on Stardent 3000) are all postloader-based 
programs. Postloading require much of the same debugging information that is 
removed by the standard strip command, so that a program that has been stripped in 
the normal sense cannot be postloaded. The Stardent 1500/3000 strip command 
retains enough information to allow current postloaders to function on the resulting 
executable. However, Stardent cannot guarantee that future postloaders will be able 
to function on executables that have been stripped by the Stardent 1500/3000 strip 
command; in particular, it is very likely that postloaders that convert Stardent 3000 
a.out files to be executable on future Stardent machines will not work on stripped exe- 
cutables. Consequently, Stardent strongly discourages users from using "the strip 
command. 

strip accepts the options listed above to maintain compatability with existing sys- 
tems. However, excepting -V, which prints version information, strip performs the 
same operations regardless of any given options, strip operates only on executables; 
when called on archives or object files, it silently does nothing. 

temporary files 



FILES 

TMPDIR/str 



TMPDIR is usually /usr/tmp but can be redefined by setting the TMPDIR environment variable (see 
tempnamO in tmpnamOS)). 

SEE ALSO 

a.out(4), ar(l), ar(4) as(l), ld(l), tmpnam(3S) 

DIAGNOSTICS 

strip: name: cannot open -if name cannot be read 

strip: name: bad magic -if name is not an appropriate file 



( 
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STTY(1) 



NAME 

SYNOPSIS 

DESCRIPTION 



Control Modes 



Input Modes 



stty - set the options for a terminal 

stty [ -a ] [ -g ] [ options ] 

stty sets certain terminal I/O options for the device that is the current standard input; 
without arguments, it reports the settings of certain options. 

In this report, if a character is preceded by a caret ( A ), then the value of that option is 
the corresponding CTRL character (e.g., " A h" is CTRL-h ; in this case, recall that 
CTRL-h is the same as the "back-space" key.) The sequence " A "' means that an 
option has a null value. For example, normally stty -a will report that the value of 
swtch is " A '"; however, if shl (1) or layers (1) has been invoked, stty -a will have the 
value " A z". 

-a reports all of the option settings; 

-g reports current settings in a form that can be used as an argument to another 
stty command. 

Options in the last group are implemented using options in the previous groups. 
Note that many combinations of options make no sense, but no sanity checking is 
performed. The options are selected from the following: 



parenb (-parenb) 

parodd (-parodd) 

cs5 cs6 cs7 cs8 



110 300 600 1200 1800 



hupcl (-hupcl) 
hup (-hup) 
cstopb (-cstopb) 
cread (-cread) 
clocal (-clocal) 
loblk (-loblk) 



ignbrk (-ignbrk) 
brkint (-brkint) 
ignpar (-ignpar) 
parmrk (-parmrk) 
inpck (-inpck) 
istrip (-istrip) 
inlcr (-inlcr) 
igncr (-igncr) 
icrnl (-icrnl) 
iuclc (-iuclc) 

ixon (-ixon) 



enable (disable) parity generation and detection, 
select odd (even) parity, 
select character size (see termio(7)). 
hang up phone line immediately. 
2400 4800 9600 19200 38400 

Set terminal baud rate to the number given, if possible. (All 
speeds are not supported by all hardware interfaces.) 
hang up (do not hang up) Dataphone connection on last close, 
same as hupcl (-hupcl). 
use two (one) stop bits per character, 
enable (disable) the receiver, 
n assume a line without (with) modem control, 
block (do not block) output from a non-current layer. 



ignore (do not ignore) break on input. 

signal (do not signal) INTR on break. 

ignore (do not ignore) parity errors. 

mark (do not mark) parity errors (see termio(7)). 

enable (disable) input parity checking. 

strip (do not strip) input characters to seven bits. 

map (do not map) NL to CR on input. 

ignore (do not ignore) CR on input. 

map (do not map) CR to NL on input. 

map (do not map) upper-case alphabetics to lower case on 

input. 

enable (disable) START/STOP output control. Output is 

stopped by sending an ASCII DC3 and started by sending an 

ASCII DC1. 
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Output Modes 



ixany (-ixany) 
ixof f (-ixof f ) 



opost (-opost) 

olcuc (-olcuc) 

onlcr (-onlcr) 
ocrnl (-ocrnl) 
onocr (-onocr) 
onlret (-onlret) 

ofill (-ofill) 

of del (-of del) 

crO crl cr2 cr3 

nlO nil 

tabO tabl tab2 tab3 

bsO bsl 

f f f f 1 

vtO vtl 



STTY(1) 

allow any character (only DO) to restart output, 
request that the system send (not send) START/STOP charac- 
ters when the input queue is nearly empty/full. 



post-process output (do not post-process output; ignore all 
other output modes). 

map (do not map) lower-case alphabetics to upper case on out- 
put. 

map (do not map) NL to CR-NL on output, 
map (do not map) CR to NL on output, 
do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the CR func- 
tion. 

use fill characters (use timing) for delays, 
fill characters are DELs (NULs). 

select style of delay for carriage returns (see termio{7)). 
select style of delay for line-feeds (see terrnio(7)). 
select style of delay for horizontal tabs (see termio{7)). 
select style of delay for backspaces (see termio{7)). 
select style of delay for form-feeds (see termio(7)). 
select style of delay for vertical tabs (see termio{7)). 



Local Modes 



Tsigt^sig) 

icanon (-icanon) 
xcase (-xcase) 
echo (-echo) 
echoe (-echoe) 



echok (-echok) 
Ifkc(-lfkc) 
echonl (-echonl) 
noflsh (-noflsh) 
stwrap (-stwrap) 

stflush (-stflush) 

stappl (-stappl) 



Control Assignments 

control-character c 



~eMM^T3Ba^eT _ the checking oFcharacters against the special 
control characters INTR, QUIT, and SWTCH. 
enable (disable) canonical input (ERASE and KILL processing), 
canonical (unprocessed) upper/lower-case presentation, 
echo back (do not echo back) every character typed, 
echo (do not echo) ERASE character as a backspace-space- 
backspace string. Note: this mode will erase the ERASEed 
character on many CRT terminals; however, it does not keep 
track of column position and, as a result, may be confusing on 
escaped characters, tabs, and backspaces, 
echo (do not echo) NL after KILL character, 
the same as echok (-echok); obsolete, 
echo (do not echo) NL. 

disable (enable) flush after INTR, QUIT, or SWTCH. 
disable (enable) truncation of lines longer than 79 characters 
on a synchronous line. (Does not apply to the 3B2.) 
enable (disable) flush on a synchronous line after every 
write(2).(Doesnotapply to 

use application mode (use line mode) on a synchronous line. 
(Does not apply to the 3B2.) 



set control-character to c, where control-character is erase, kill, 
intr, quit, swtch, eof, ctab, min, or time (ctab is used with 
-stappl; min and time are used with -icanon; see termio{7)). If 
c is preceded by an (escaped from the shell) caret ( A ), then the 
value used is the corresponding CTRL character (e.g., " A d" is a 
CTRL-d); " A ?" is interpreted as DEL and " A -" is interpreted as 
undefined. 



c 



( 



c 
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line i 



set line discipline to i (0 < i < 127 ). 



Combination Modes 

evenp or parity 



SEE ALSO 



enable parenb and cs7. 
oddp enable parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

disable parenb, and set cs8. 
raw (-raw or cooked) enable (disable) raw input and output (no ERASE, KILL, INTR, 

QUIT, SWTCH, EOT, or output post processing). 

unset (set) icrnl, onlcr. In addition -nl unsets inlcr, igncr, 

ocrnl, and onlret. 

set (unset) xcase, iuclc, and olcuc. 

same as lease (-lease). 

preserve (expand to spaces) tabs when printing. 

reset ERASE and KILL characters back to normal # and @. 

resets all modes to some reasonable values. 

set all modes suitable for the terminal type term, where term is 

one of tty33, tty37, vt05, tn300, ti700, or tek. 



nl (-nl) 

lease (-lease) 

LCASE (-LCASE) 

tabs (-tabs or tab3) 

ek 

sane 

term 



ioctl(2), tabs(l), termio(7). 
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SYNOPSIS 

DESCRIPTION 



STTY (IB) 



stty - set terminal options 

stty [ option ... ] 

Stty sets certain I/O options on the current output terminal, placing its output on the 
diagnostic output. With no argument, it reports the speed of the terminal and the 
settings of the options which are different from their defaults. Use of one of the fol- 
lowing options modifies the output as described: 

all All normally used option settings are reported. 

everything 

Everything stty knows about is printed. 

speed The terminal speed alone is printed on the standard output. 

size The terminal (window) sizes are printed on the standard output, first 

rows and then columns. 

The option strings are selected from the following set: 

even allow even parity input 

-even disallow even parity input 

odd allow odd parity input 

-odd disallow odd parity input 



( 



"raw raiv~mTxte4iTpu±-^ 

passed back) 

-raw negate raw mode 

cooked same as -raw' 

cbreak make each character available to read (2) as received; no erase and kill pro- 
cessing, but all other processing (interrupt, suspend, ...) is performed 

-cbreak make characters available to read only when newline is received 

-nl allow carriage return for new-line, and output CR-LF for carriage return 

or new-line 

nl accept only new-line to end lines 

echo echo back every character typed 

-echo do not echo characters 

lease map upper case to lower case 

-lease do not map case 

tandem enable flow control, so that the system sends out the stop character when 
its internal queue is in danger of overflowing on input, and sends the 
start character when it is ready to accept further input 

-tandem disable flow control 

-tabs replace tabs by spaces when printing 

tabs preserve tabs 

ek set erase and kill characters to # and @ 

For the following commands which take a character argument c, you may also 

specify c as the "u" or "undef ', to set the value to be undefined. A value of " A x" ', a 2 

character sequence, is also interpreted as a control character, with " A ?" representing 

delete. 

erase c set erase character to c (default '#', but often reset to A H.) 
kill c set kill character to c (default '©', but often reset to A U.) 

intr c set interrupt character to c (default DEL or A ? (delete), but often reset to 

A C) 



c 



c 
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quit c set quit character to c (default control \.) 

start c set start character to c (default control Q.) 

stop c set stop character to c (default control S.) 

eof c set end of file character to c (default control D.) 

brk c set break character to c (default undefined.) This character is an addi- 

tional character causing wakeup. 

crO crl cr2 cr3 

select style of delay for carriage return (see ioctl(2)) 

nlO nil nl2 nl3 

select style of delay for linefeed 

tabO tabl tab2 tab3 

select style of delay for tab 

f f ff 1 select style of delay for form feed 

bsO bsl select style of delay for backspace 

tty33 set all modes suitable for the Teletype Corporation Model 33 terminal. 

tty37 set all modes suitable for the Teletype Corporation Model 37 terminal. 

vt05 set all modes suitable for Digital Equipment Corp. VT05 terminal 

dec set all modes suitable for Digital Equipment Corp. operating systems 

users; (erase, kill, and interrupt characters to A ?, A U, and A C, decctlq and 

"newcrt".) 

tn300 set all modes suitable for a General Electric TermiNet 300 

ti700 set all modes suitable for Texas Instruments 700 series terminal 

tek set all modes suitable for Tektronix 4014 terminal 

hang up phone line immediately 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 

Set terminal baud rate to the number given, if possible. (These are the 

speeds supported by the DH-11 interface). 

rows n The terminal size is recorded as having n rows. 

columns n The terminal size is recorded as having n columns. 

cols n is an alias for columns . 

A teletype driver which supports the job control processing of csh(l) and more func- 
tionality than the basic driver is fully described in tfy(4). The following options 
apply only to it. 

new Use new driver (switching flushes typeahead). 

crt Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud, crterase and 

crtkill.) 
crtbs Echo backspaces on erase characters. 

prterase For printing terminal echo erased characters backwards within "\" and 

crterase Wipe out erased characters with "backspace-space-backspace." 

-crterase Leave erased characters visible; just backspace. 

crtkill Wipe out input on like kill ala crterase. 

-crtkill Just echo line kill character and a newline on line kill. 

ctlecho Echo control characters as //y V (and delete as " A ?".) Print two back- 
spaces following the EOT character (control D). 

-ctlecho Control characters echo as themselves; in cooked mode EOT (control-D) is 
not echoed. 

decctlq After output is suspended (normally by A S), only a start character (nor- 
mally A Q) will restart it. This is compatible with DECs vendor supplied 
systems. 
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-decctlq 



tostop 

-tostop 

tilde 

-tilde 

flusho 

-flusho 
pendin 

-pendin 

pass8 

-pass8 

mdmbuf 

-mdmbuf Return error if write attempted after carrier drops. 

litout Send output characters without any processing. 

-litout Do normal output processing, inserting delays, etc. 

nohang Don't send hangup signal if carrier drops. 

-nohang Send hangup signal to control process group when carrier drops. 

etxack Diablo style etx/ack handshaking (not implemented). 

The following special characters are applicable only to the new teletype driver and 
are not normally changed. 



After output is suspended, any character typed will restart it; the start 

character will restart output without providing any input. (This is the 

default.) 

Background jobs stop if they attempt terminal output. 

Output from background jobs to the terminal is allowed. 

Convert "~" to " s " on output (for Hazeltine terminals). 

Leave poor "~" alone. 

Output is being discarded usually because user hit control O (internal 

state bit). 

Output is not being discarded. 

Input is pending after a switch from cbreak to cooked and will be re-input 

when a read becomes pending or more input arrives (internal state bit). 

Input is not pending. 

Passes all 8 bits through on input, in any mode. 

Strips the 0200 bit on input except in raw mode. 

Start/stop output on carrier transitions (not implemented). 



( 



SEE ALSO 



susp c set suspend process character to c (default control Z). 

dsusp c set delayed suspend process character to c (default control Y). 

rprnt c set reprint line character to c (default control R). 

flush c set flush output character to c (default control O). 

werase c set word erase character to c (default control W). 

lnext c set literal next character to c (default control V). 

ioctl(2), tabs(l), tset(l), tty(4) 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLES 



FILES 



SEE ALSO 



SU(1M) 



su - become super-user or another user 

su [ - ] [ name [ arg . . . ] ] 

su allows one to become another user without logging off. The default user name is 
root (i.e., super-user). 

To use su, the appropriate password must be supplied (unless one is already root). If 
the password is correct, su will execute a new shell with the real and effective user ID 
set to that of the specified user. The new shell will be the optional program named in 
the shell field of the specified user's password file entry (see passwd(4)), or /bin/sh if 
none is specified (see sh(D). To restore normal user ID privileges, type an EOF (cntrl- 
d) to the new shell. 

Any additional arguments given on the command line are passed to the program 
invoked as the shell. When using programs like sh{\), an arg of the form -c string 
executes string via the shell and an arg of -r will give the user a restricted shell. 

The following statements are true only if the optional program named in the shell 
field of the specified user's password file entry is like sh(l). If the first argument to su 
is a -, the environment will be changed to what would be expected if the user actu- 
ally logged in as the specified user. This is done by invoking the program used as 
the shell with an argO value whose first character is -, thus causing first the system's 
profile (/etc/profile) and then the specified user's profile (.profile in the new HOME 
directory) to be executed. Otherwise, the environment is passed along with the pos- 
sible exception of $PATH, which is set to /bin:/etc:/usr/bin for root. Note that if the 
optional program used as the shell is /bin/sh, the user's .profile can check argO for 
-sh or -su to determine if it was invoked by loginil) or su{\), respectively. If the 
user's program is other than /bin/sh, then .profile is invoked with an argO of -program 
by both login{\) and su{l). 

All attempts to become another user using su are logged in the log file 
/usr/adm/sulog. 

To become user bin while retaining your previously exported environment, execute: 

subin 

To become user bin but change the environment to what would be expected if bin 
had originally logged in, execute: 

su - bin 

To execute command with the temporary environment and permissions of user bin, 
type: 

su - bin ~c "command args 11 

/etc/passwd system's password file 

/etc/ profile system's profile 

$HOME/. profile user's profile 

/usr/adm/sulog log file 

env(l), login(l), passwd(4), profile(4), sh(l). 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



SUM(1) 



sum - print checksum and block count of a file 

sum [ -r ] file 

sum calculates and prints a 16-bit checksum for the named file, and also prints the 
number of blocks in the file. It is typically used to look for bad spots, or to validate a 
file communicated over some transmission line. The option -r causes an alternate 
algorithm to be used in computing the checksum. 



wc(l). 



"Read error" is indistinguishable from end of file on most devices; check the block 
count. 



(. 



( 
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NAME 
SYNOPSIS 



swap - swap administrative interface 



/etc/swap -a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -1 

DESCRIPTION 

swap provides a method of adding, deleting, and monitoring the system swap areas 
used by the memory manager. The following options are recognized: 

-a Add the specified swap area, swapdev is the name of the block special device, 
e.g., /dev/dsk/c0dls4. swaplow is the offset in 512-byte blocks into the device 
where the swap area should begin, swaplen is the length of the swap area in 
512-byte blocks. This option can only be used by the super-user. Swap areas 
are normally added by the system start up routine /etc/rc when going into 
multi-user mode. 

-d Delete the specified swap area, swapdev is the name of block special device, e.g., 
/dev/dsk/c0dls4. swaplow is the offset in 512-byte blocks into the device where 
the swap area should begin. Using this option marks the swap area as "INDEL" 
(in process of being deleted). The system will not allocate any new blocks from 
the area, and will try to free swap blocks from it. The area will remain in use 
until all blocks from it are freed. This option can only be used by the super- 
user. 

-1 List the status of all the swap areas. The output has four columns: 

DEV The swapdev special file for the swap area if one can be found in the 
/dev/dsk or /dev directories, and its major/minor device number in 
decimal. 

LOW 

The swaplow value for the area in 512-byte blocks. 

LEN The swaplen value for the area in 512-byte blocks. 

FREE 

The number of free 512-byte blocks in the area. If the swap area is being 
deleted, this column will be marked INDEL. 

WARNINGS 

No check is done to see if a swap area being added overlaps with an existing swap 
area or file system. 
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NAME ( 

sync - update the super block ^ 

SYNOPSIS 

sync 

DESCRIPTION 

sync executes the sync system primitive. If the system is to be stopped, sync must be 
called to insure file system integrity. It will flush all previously unwritten system 
buffers out to disk, thus assuring that all file modifications up to that point will be 
saved. See sync (2) for details. 

SEE ALSO 

sync(2) 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



tabs - set tabs on a terminal 

tabs [tabspec] [-Ttype] [+mn] 

tabs sets the tab stops on the user's terminal according to the tab specification tabspec, 
after clearing any previous settings. The user's terminal must have remotely-settable 
hardware tabs. 

tabspec Four types of tab specification are accepted for tabspec. They are described 
below: canned (-code), repetitive (-rc), arbitrary (nl,n2,...), and file (—file). If 
no tabspec is given, the default value is -8, i.e., UNIX system "standard" tabs. 
The lowest column number is 1. Note that for tabs, column 1 always refers 
to the leftmost column on a terminal, even one whose column markers 
begin at 0, e.g., the DASI 300, DASI 300s, and DASI 450. 

-code Use one of the codes listed below to select a canned set of tabs. The legal 
codes and their meanings are as follows: 
-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this code, 

the first typed character corresponds to card column 7, one space 

gets you to column 8, and a tab reaches column 12. Files using this 

tab setup should include a format specification as follows (see 

fspec(4:)): 

<:t-c2 m6 s66 d:> 
-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with more tabs than 

-c2. This is the recommended format for COBOL. The appropriate 

format specification is (see fspec(4)): 
<:t-c3 m6 s66 d:> 
-f 1,7,11,15,19,23 

FORTRAN 
-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 
-s 1,10,55 

SNOBOL 
-u 1,12,20,44 

UNIVAC 1100 Assembler 
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-n A repetitive specification requests tabs at columns 1+rc, l+2*n, etc. Of partic- | 

ular importance is the value 8: this represents the UNIX system "standard" ^ 

tab setting, and is the most likely tab setting to be found at a terminal. 
Another special case is the value 0, implying no tabs at all. 

n2,n2,... The arbitrary format permits the user to type any chosen set of numbers, 
separated by commas, in ascending order. Up to 40 numbers are allowed. 
If any number (except the first one) is preceded by a plus sign, it is taken as 
an increment to be added to the previous value. Thus, the formats 
1,10,20,30, and 1,10,+10,+10 are considered identical. 

—file If the name of a file is given, tabs reads the first line of the file, searching for 
a format specification (see fspec(4)). If it finds one there, it sets the tab stops 
according to it, otherwise it sets them as -8. This type of specification may 
be used to make sure that a tabbed file is printed with correct tab settings, 
and would be used with the pr(l) command: 
tabs — - file; pr file 

Any of the following also may be used; if a given flag occurs more than once, the last 
value given takes effect: 

-Ttype tabs usually needs to know the type of terminal in order to set tabs and 
always needs to know the type to set margins, type is a name listed in 
terra (5). If no -T flag is supplied, tabs uses the value of the environment 
variable TERM. If TERM is not defined in the environment (see environ{5)) f 
tabs tries a sequence that will work for many terminals. 

+mn The margin argument may be used for some terminals. It causes all tabs to 
be moved over n columns by making column n+1 the left margin. If +m is 
given without a value of n, the value assumed is 10. For a TermiNet, the 
first value in the tab list should be 1, or the margin will move even further 
to the right. The normal (leftmost) margin on most terminals is obtained by 
+m0. The margin for most terminals is reset only when the +m flag is given 
explicitly. 

Tab and margin setting is performed via the standard output. 
EXAMPLES 

tabs -a example using -code {canned specification) to set tabs to the settings required 
by the IBM assembler: columns 1, 10, 16, 36, 72. 

tabs -8 example of using -n {repetitive specification), where n is 8, causes tabs to be 
set every eighth position: 
1+(1*8), l+(2*8), ... which evaluate to columns 9, 17, ... 

tabs 1,8,36 

example of using nl ,n2,... (arbitrary specification) to set tabs at columns 1, 8, 
and 36. 

tabs — $HOME/fspec.list/att4425 

example of using — file (file specification) to indicate that tabs should be set 
according to the first line of $HOME/fspec.list/att4425 (see fspec(4)). 

DIAGNOSTICS 

illegal tabs when arbitrary tabs are ordered incorrectly 

illegal increment when a zero or missing increment is found in an arbitrary 

specification 
unknown tab code when a canned code cannot be found 
can't open if —file option used, and file can't be opened 



( 
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SEE ALSO 
NOTE 



WARNING 



file indirection if — file option used and the specification in that file points to yet 
another file. Indirection of this form is not permitted 

newform(l), pr(l), tput(l), fspec(4), terminfo(4), environ(5), term(5). 

There is no consistency among different terminals regarding ways of clearing tabs 
and setting the left margin. 

tabs clears only 20 tabs (on terminals requiring a long sequence), but is willing to set 
64. 

The tabspec used with the tabs command is different from the one used with the 
nezvformd) command. For example, tabs -8 sets every eighth position; whereas 
newf orm -i-8 indicates that tabs are set every eighth position. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



TAIL(1) 



tail - deliver the last part of a file 

tail [ ±[number][lbc[rf] ] ] [ file ] 

tail copies the named file to the standard output beginning at a designated place. If 
no file is named, the standard input is used. 

Copying begins at distance ^number from the beginning, or -number from the end of 
the input (if number is null, the value 10 is assumed). Number is counted in units of 
lines, blocks, or characters, according to the appended option 1, b, or c. When no 
units are specified, counting is by lines. 

Specifying r causes tail to print lines from the end of the file in reverse order. The 
default for r is to print the entire file this way. 

With the -f ("follow") option, if the input file is not a pipe, the program will not ter- 
minate after the line of the input file has been copied, but will enter an endless loop, 
wherein it sleeps for a second and then attempts to read and copy further records 
from the input file. Thus it may be used to monitor the growth of a file that is being 
written by some other process. 

For example, the command: 

tail -f fred 

will print the last ten lines of the file fred, followed by any lines that are appended_to_ 



fred between the time tail is initiated and killed. As another example, the command: 

tail -15cf fred 

will print the last 15 characters of the file fred, followed by any lines that are 
appended to fred between the time tail is initiated and killed. 

dd(lM). 

Tails relative to the end of the file are stored in a buffer, and thus are limited in 
length. Various kinds of anomalous behavior may happen with character special 
files. 



c 
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NAME 

SYNOPSIS 

DESCRIPTION 



TAR(1) 



tar - tape archiver 

tar [key] [name ...] 

tar saves and restores multiple files on a single file (usually a magnetic tape, but it 
can be any file), tar's actions are controlled by the key argument. The key is a string of 
characters containing at most one function letter and possibly one or more function 
modifiers. Other arguments to tar are file or directory names specifying which files 
to dump or restore. In all cases, appearance of a directory name refers to the files 
and (recursively) subdirectories of that directory. 

The function portion of the key is specified by one of the following letters: 

r The named files are written on the end of the tape. The c function implies 

this. 

x The named files are extracted from the tape. If the named file matches a 

directory whose contents had been written onto the tape, this directory is 
(recursively) extracted. The owner, modification time, and mode are 
restored (if possible). If no file argument is given, the entire content of the 
tape is extracted. Note that if multiple entries specifying the same file are 
on the tape, the last one overwrites all earlier. 

t The names of the specified files are listed each time they occur on the tape. 

If no file argument is given, all of the names on the tape are listed. 

u The named files are added to the tape if either they are not already there or 

have been modified since last put on the tape. 

c Create a new tape; writing begins on the beginning of the tape instead of 

after the last file. This command implies r. 

The following characters may be used in addition to the function letter. 

o On output, tar normally places information specifying owner and modes 

of directories in the archive. Former versions of tar, when encountering 
this information will give error message of the form 

"<name>/: cannot create". 
This modifier will suppress the directory information. 

p This modifier says to restore files to their original modes, ignoring the 

present umask{2). Setuid and sticky information will also be restored to 
the super-user. 

0, ..., 9 This modifier selects an alternate drive on which the tape is mounted. 
The default is drive at 1600 bpi, which is normally /dev/rmt8. 

v Normally tar does its work silently. The v (verbose) option makes tar 

print the name of each file it treats preceded by the function letter. With 
the t function, the verbose option gives more information about the tape 
entries than just their names. 

w tar prints the action to be taken followed by file name, then wait for user 

confirmation. If a word beginning with 'y' is given, the action is done. 
Any other input means don't do it. 

f tar uses the next argument as the name of the archive instead of 

/dev/rmt?. If the name of the file is '-', tar writes to standard output or 
reads from standard input, whichever is appropriate. Thus, tar can be 
used as the head or tail of a filter chain, tar can also be used to move 
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FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 



hierarchies with the command 

cd f romdir; tar cf - . 



(cd todir; tar xf -) 



m 
h 
I 

B 



tar uses the next argument as the blocking factor for tape records. The 
default is 20 (the maximum). This option should only be used with raw 
magnetic tape archives (See f above). The block size is determined 
automatically when reading tapes (key letters V and 't'). 

tells tar to complain if it cannot resolve all of the links to the files dumped. 
If this is not specified, no error messages are printed. 

tells tar not to restore the modification times. The modification time will 
be the time of extraction. 

Force tar to follow symbolic links as if they were normal files or direc- 
tories. Normally, tar does not follow symbolic links. 

tar uses the next argument as a filename that contains a list of files for tar 
to write to an archive. The list consists of one file per line. Some options 
are allowed in the file list, discussed below. The I keyletter is ignored 
when reading an archive. 

Forces input and output blocking to 20 blocks per record. This option 
was added so that tar can work across a communications channel where 
the blocking may not be maintained. 

C If a file name is preceded by -C, then tar will perform a chdir(2) to that file 

name. This allows multiple directories not related by a close common 
parent to be archived using short relative path names. For example, to 
archive files from /usr/include and from /etc, one might use 
tar c -C /usr include -C / etc 

If the I keyletter is used, each filename in the list of files may have one of the follow- 
ing options preceding it (separated by a space): -C has the same meaning as above, 
causing a chdir to the named directory, -d forces a particular directory to be written 
without getting its contents. It is necessary to list a directory in this manner before 
listing all the files in that directory, -h and +h override the non-existence or 
existence of the h keyletter on the command line. The h keyletter sets a flag telling 
tar to follow symbolic links. The -h option has the same effect on a per-file basis, or 
sets the flag for subsequent files if on a line by itself. The +h option resets the flag 
either for a particular file or for subsequent files in the same manner. 

Previous restrictions dealing with tar's inability to properly handle blocked archives 
have been lifted. 

/dev/rmt? 
/tmp/tar* 



tar(5) 



Complaints about bad key characters and tape read /write errors. 
Complaints if enough memory is not available to hold the link tables. 

There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. When extracting tapes created with the r or u options, 

directory modification times may not be set correctly. 

The current limit on file name length is 100 characters. 
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NAME 



SYNOPSIS 
DESCRIPTION 



tcopy - copy a mag tape 
tcopy src [ dest ] 



Tcopy is designed to copy magnetic tapes. The only assumption made about the tape 
is that there are two tape marks at the end. Tcopy with only a source tape specified 
will print information about the sizes of records and tape files. If a destination is 
specified, then, a copy will be made of the source tape. The blocking on the destina- 
tion tape will be identical to that used on the source tape. Copying a tape will yield 
the same output as if just printing the sizes. 

SEE ALSO 

mtio(4) 
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NAME ( 

tee - pipe fitting 



SYNOPSIS 
DESCRIPTION 



tee [-i] [-a] [file]... 

tee transcribes the standard input to the standard output and makes copies in the 
files. The 

-i ignore interrupts; 

-a causes the output to be appended to the files rather than overwriting them. 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



TELNET (1C) 



telnet - user interface to the TELNET protocol 

telnet [ host [ port ] ] 

telnet is used to communicate with another host using the TELNET protocol. If telnet 
is invoked without arguments, it enters command mode, indicated by its prompt 
("telnet>"). In this mode, it accepts and executes the commands listed below. If it is 
invoked with arguments, it performs an open command (see below) with those argu- 
ments. 

Once a connection has been opened, telnet enters an input mode. The input mode 
entered will be either "character at a time" or "line by line" depending on what the 
remote system supports. 

In "character at a time" mode, most text typed is immediately sent to the remote host 
for processing. 

In "line by line" mode, all text is echoed locally, and (normally) only completed lines 
are sent to the remote host. The "local echo character" (initially " A E") may be used 
to turn off and on the local echo (this would mostly be used to enter passwords 
without the password being echoed). 

In either mode, if the localchars toggle is TRUE (the default in line mode; see below), 
the user's quit, intr, and flush characters are trapped locally, and sent as TELNET 
protocol sequences to the remote side. There are options (see toggle autoflush and 
toggle autosynch below) which cause this action to flush subsequent output to the ter- 
minal (until the remote host acknowledges the TELNET sequence) and flush previ- 
ous terminal input (in the case of quit and intr). 

While connected to a remote host, telnet command mode may be entered by typing 
the telnet "escape character" (initially " A ]"). When in command mode, the normal 
terminal editing conventions are available. 

COMMANDS 

The following commands are available. Only enough of each command to uniquely 
identify it need be typed (this is also true for arguments to the mode, set, toggle, and 
display commands). 

o-pen host [port] 

Open a connection to the named host. If no port number is specified, telnet will 
attempt to contact a TELNET server at the default port. The host specification 
may be either a host name (see hosts(5)) or an Internet address specified in the 
"dot notation" (see inetON)). 



close 



Close a TELNET session and return to command mode. 



quit 



Close any open TELNET session and exit telnet. 
mode) will also close a session and exit. 



An end of file (in command 



Suspend telnet. This command only works when the user is using the csh(l). 

mode type 

Type is either line (for "line by line" mode) or character (for "character at a time" 
mode). The remote host is asked for permission to go into the requested mode. 
If the remote host is capable of entering that mode, the requested mode will be 
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entered. 

status 

Show the current status of telnet. This includes the peer one is connected to, as 
well as the current mode. 

display [ argument... ] 

Displays all, or some, of the set and toggle values (see below). 

? [ command ] 

Get help. With no arguments, telnet prints a help summary. If a command is 
specified, telnet will print the help information for just that command. 

send arguments 

Sends one or more special character sequences to the remote host. The follow- 
ing are the arguments which may be specified (more than one argument may 
be specified at a time): 

escape 

Sends the current telnet escape character (initially " A J"). 

synch 

Sends the TELNET SYNCH sequence. This sequence causes the remote 
system to discard all previously typed (but not yet read) input. This 
sequence is sent as TCP urgent data (and may not work if the remote sys- 
tem is a 4.2 BSD system ~ if it doesn't work, a lower case "r" may be 
echoed on the terminal). 

brk 

Sends the TELNET BRK (Break) sequence, which may have significance 
to the remote system. 

Sends the TELNET IP (Interrupt Process) sequence, which should cause 
the remote system to abort the currently running process. 

Sends the TELNET AO (Abort Output) sequence, which should cause the 
remote system to flush all output from the remote system to the user's 
terminal. 

Sends the TELNET AYT (Are You There) sequence, to which the remote 
system may or may not choose to respond. 

Sends the TELNET EC (Erase Character) sequence, which should cause 
the remote system to erase the last character entered. 

Sends the TELNET EL (Erase Line) sequence, which should cause the 
remote system to erase the line currently being entered. 

Sends the TELNET GA (Go Ahead) sequence, which likely has no 
significance to the remote system. 

nop 

Sends the TELNET NOP (No OPeration) sequence. 

Prints out help information for the send command. 



ip 



ao 



ayt 



ec 



el 



ga 



c 
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set argument value 

Set any one of a number of telnet variables to a specific value. The special value 
"off turns off the function associated with the variable. The values of vari- 
ables may be interrogated with the display command. The variables which 
may be specified are: 

echo 

This is the value (initially " A E") which, when in "line by line" mode, tog- 
gles between doing local echoing of entered characters (for normal pro- 
cessing), and suppressing echoing of entered characters (for entering, say, 
a password). 

escape 

This is the telnet escape character (initially " A [") which causes entry into 
telnet command mode (when connected to a remote system). 

interrupt 

If telnet is in localchars mode (see toggle localchars below) and the interrupt 
character is typed, a TELNET IP sequence (see send ip above) is sent to 
the remote host. The initial value for the interrupt character is taken to be 
the terminal's intr character. 

quit 

If telnet is in localchars mode (see toggle localchars below) and the quit char- 
acter is typed, a TELNET BRK sequence (see send brk above) is sent to 
the remote host. The initial value for the quit character is taken to be the 
terminal's quit character. 

flushoutput 

If telnet is in localchars mode (see toggle localchars below) and the flushout- 
put character is typed, a TELNET AO sequence (see send ao above) is sent 
to the remote host. The initial value for the flush character is taken to be 
the terminal's flush character. 

erase 

If telnet is in localchars mode (see toggle localchars below), and if telnet is 
operating in "character at a time" mode, then when this character is 
typed, a TELNET EC sequence (see send ec above) is sent to the remote 
system. The initial value for the erase character is taken to be the 
terminal's erase character. 

If telnet is in localchars mode (see toggle localchars below), and if telnet is 
operating in "character at a time" mode, then when this character is 
typed, a TELNET EL sequence (see send el above) is sent to the remote 
system. The initial value for the kill character is taken to be the terminal's 
kill character. 

If telnet is operating in "line by line" mode, entering this character as the 
first character on a line will cause this character to be sent to the remote 
system. The initial value of the eof character is taken to be the terminal's 
eof character. 

toggle arguments... 

Toggle (between TRUE and FALSE) various flags that control how telnet 
responds to events. More than one argument may be specified. The state of 
these flags may be interrogated with the display command. Valid arguments 
are: 



kill 



eof 
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localchars 

If this is TRUE, then the flush, interrupt, quit, erase, and kill characters (see 
set above) are recognized locally, and transformed into (hopefully) 
appropriate TELNET control sequences (respectively ao, ip, brk, ec, and el; 
see send above). The initial value for this toggle is TRUE in "line by line" 
mode, and FALSE in "character at a time" mode. 

autoflush 

If autoflush and localchars are both TRUE, then when the ao, intr, or quit 
characters are recognized (and transformed into TELNET sequences; see 
set above for details), telnet refuses to display any data on the user's ter- 
minal until the remote system acknowledges (via a TELNET Timing Mark 
option) that it has processed those TELNET sequences. The initial value 
for this toggle is TRUE if the terminal user had not done an "stty noflsh", 
otherwise FALSE (see stty(D). 

autosynch 

If autosynch and localchars are both TRUE, then when either the intr or quit 
characters is typed (see set above for descriptions of the intr and quit char- 
acters), the resulting TELNET sequence sent is followed by the TELNET 
SYNCH sequence. This procedure should cause the remote system to 
begin throwing away all previously typed input until both of the TEL- 
NET sequences have been read and acted upon. The initial value of this 
toggle is FALSE. 

crmod 

Toggle carriage return mode. When this mode is enabled, most carriage 
return characters received from the remote host will be mapped into a 
carriage return followed by a line feed. This mode does not affect those 
characters typed by the user, only those received from the remote host. 
This mode is not very useful unless the remote host only sends carriage 
return, but never line feed. The initial value for this toggle is FALSE. 

debug 

Toggles socket level debugging (useful only to the superuser). The initial 
value for this toggle is FALSE. 

options 

Toggles the display of some internal telnet protocol processing (having to 
do with TELNET options). The initial value for this toggle is FALSE. 

netdata 

Toggles the display of all network data (in hexadecimal format). The ini- 
tial value for this toggle is FALSE. 

? 

Displays the legal toggle commands. 

BUGS 

There is no adequate way for dealing with flow control. 

On some remote systems, echo has to be turned off manually when in "line by line" 
mode. 

There is enough settable state to justify a .telnetrc file. 

No capability for a .telnetrc file is provided. 

In "line by line" mode, the terminal's eof character is only recognized (and sent to the 
remote system) when it is the first character on a line. 
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TEST(1) 

NAME 
SYNOPSIS 

DESCRIPTION 



TEST(1) 



test - condition evaluation command 

test expr 
[ expr ] 

test evaluates the expression expr and, if its value is true, sets a zero (true) exit status; 
otherwise, a non-zero (false) exit status is set; test also sets a non-zero exit status if 
there are no arguments. When permissions are tested, the effective user ID of the 
process is used. 

All operators, flags, and brackets (brackets used as shown in the second SYNOPSIS 
line) must be separate arguments to the test command; normally these items are 
separated by spaces. 

The following primitives are used to construct expr: 

-tfile 

-w file 

-x file 

-{file 

-dfile 

-c file 

-Ay file 

-p file 

-u file 

-g file 

-kfile 

-I file 

-s file 

-t [ fildes ] 

-zsl 

-nsl 

si =s2 

si != s2 

si 

nl -eq nl 



true ii file exists and is readable. 

true if file exists and is writable. 

true ii file exists and is executable. 

true ii file exists and is a regular file. 

true if file exists and is a directory. 

true if file exists and is a character special file. 

true if file exists and is a block special file. 

true iifile exists and is a named pipe (fifo). 

true if file exists and its set-user-ID bit is set. 

true iifile exists and its set-group-ID bit is set. 

true if file exists and its sticky bit is set. 

true iifile is a symbolic link 

true iifile exists and has a size greater than zero. 

true if the open file whose file descriptor number is fildes (1 by default) 
is associated with a terminal device. 

true if the length of string si is zero. 

true if the length of the string si is non-zero. 

true if strings si and s2 are identical. 

true if strings si and s2 are not identical. 

true if si is not the null string. 

true if the integers nl and n2 are algebraically equal. Any of the com- 
parisons -ne, -gt, -ge, -It, and -le may be used in place of -eq. 

These primaries may be combined with the following operators: 

! unary negation operator. 

-a binary and operator. 

_o binary or operator (-a has higher precedence than -o). 



Stardent 1500/3000 



433 



Essential Utilities 



TEST(1) TEST(1) 

( expr ) parentheses for grouping. Notice also that parentheses are meaningful I 

to the shell and, therefore, must be quoted. ^ 

SEE ALSO 

find(l), sh(l). 

WARNING 

If you test a file you own (the -r, -w, or -x tests), but the permission tested does not 
have the owner bit set, a non-zero (false) exit status will be returned even though the 
file may have the group or other bit set for that permission. The correct exit status 
will be set if you are super-user. 

The = and != operators have a higher precedence than the -r through -n operators, 
and = and != always expect arguments; therefore, = and !~ cannot be used with the -r 
through -n operators. 

If more than one argument follows the -r through -n operators, only the first argu- 
ment is examined; the others are ignored, unless a -a or a -o is the second argument. 
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TFTP(1C) 

NAME 

SYNOPSIS 

DESCRIPTION 



COMMANDS 



TFTP(1C) 



tftp - transfer files using DARPA Trivial File Transfer Protocol 

tftp [ host ] 

tftp is the user interface to the Internet TFTP (Trivial File Transfer Protocol), which 
allows users to transfer files to and from a remote machine. The remote host may be 
specified on the command line, in which case tftp uses host as the default host for 
future transfers (see the connect command below). 

Once tftp is running, it issues the prompt tftp> and recognizes the following com- 
mands: 

connect host-name [ port ] 

Set the host (and optionally port) for transfers. Note that the TFTP protocol, 
unlike the FTP protocol, does not maintain connections between transfers; thus, 
the connect command does not actually create a connection, but merely 
remembers what host is to be used for transfers. You do not have to use the 
connect command; the remote host can be specified as part of the get or put com- 
mands. 

mode transfer-mode 

Set the mode for transfers; transfer-mode may be one of ascii or binary. The 
default is ascii. 

-put file 

put localfile remotefile 

put filel file! ... fileN remote-directory 

Put a file or set of files to the specified remote file or directory. The destination 
can be in one of two forms: a filename on the remote host, if the host has 
already been specified, or a string of the form hostfilename to specify both a host 
and filename at the same time. If the latter form is used, the hostname specified 
becomes the default for future transfers. If the remote-directory form is used, 
the remote host is assumed to be a UNIX machine. 

get filename 

get remotename localname 

get filel file! ... fileN 

Get a file or set of files from the specified sources . Source can be in one of two 
forms: a filename on the remote host, if the host has already been specified, or 
a string of the form hostifilename to specify both a host and filename at the same 
time. If the latter form is used, the last hostname specified becomes the default 
for future transfers. 

quit Exit tftp. An end of file also exits. 

verbose 

Toggle verbose mode. 

trace Toggle packet tracing. 

status 

Show current status. 

rexmt retransmission-timeout 

Set the per-packet retransmission timeout, in seconds. 
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TFTP(1C) 



SEE ALSO 



BUGS 



timeout total-transmission-timeout 

Set the total transmission timeout, in seconds. 

ascii Shorthand for "mode ascii" 

binary 

Shorthand for "mode binary" 

? [command-name...] 

Print help information. 

tftpd(8C), RFC 783 - The TFTP Protocol (Network Information Center, SRI Interna- 
tional) 

Because there is no user-login or validation within the TFTP protocol, the remote site 
will probably have some sort of file-access restrictions in place. The exact methods 
are specific to each site and therefore difficult to document here. 

tftp does nothing special with "mail" mode transfers. Most servers don't handle the 
mail mode either. 
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T1C(1M) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
WARNINGS 



BUGS 



TIC(1M) 



tic - terminfo compiler 

tic [-v[n]] [-c] file 

tic translates a terminfo(4) file from the source format into the compiled format. The 
results are placed in the directory /usr/lib/terminfo. The compiled format is necessary 
for use with the library routines described in curses(3X). 

-vn (verbose) output to standard error trace information showing tic's progress. 
The optional integer n is a number from 1 to 10, inclusive, indicating the 
desired level of detail of information. If n is omitted, the default level is 1. 
If n is specified and greater than 1, the level of detail is increased. 

-c only check file for errors. Errors in use= links are not detected. 

file contains one or more terminfo(4) terminal descriptions in source format (see 

terminfo(4t)). Each description in the file describes the capabilities of a partic- 
ular terminal. When a use=entry-name field is discovered in a terminal entry 
currently being compiled, tic reads in the binary from jusr/lib/terminfo to 
complete the entry. (Entries created from file will be used first. If the 
environment variable TERMINFO is set, that directory is searched instead of 
/usr/lib/terminfo.) tic duplicates the capabilities in entry-name for the current 
entry, with the exception of those capabilities that explicitly are defined in 
the current entry. 

If the environment variable TERMINFO is set, the compiled results are placed there 
instead of /usr/lib/terminfo. 

/usr/lib/terminfo/?/* compiled terminal description data base 

curses(3X), term(4), terminfo(4). 

Total compiled entries cannot exceed 4096 bytes. The name field cannot exceed 128 
bytes. 

Terminal names exceeding 14 characters will be truncated to 14 characters and a 
warning message will be printed. 

When the -c option is used, duplicate terminal names will not be diagnosed; how- 
ever, when -c is not used, they will be. 

To allow existing executables from the previous release of the UNIX System to con- 
tinue to run with the compiled terminfo entries created by the new terminfo com- 
piler, cancelled capabilities will not be marked as cancelled within the terminfo 
binary unless the entry name has a V within it. (Such terminal names are only used 
for inclusion within other entries via a use= entry. Such names would not be used 
for real terminal names.) 

For example: 
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4415+nl, kfl@, kf2@, .... 

4415+base, kfl=\EOc, kf2=\EOd, .... 

4415-nl 1 4415 terminal without keys, 
use=4415+nl, use=4415+base, 

The above example works as expected; the definitions for the keys do not show up in 
the 4415-nl entry. However, if the entry 4415+nl did not have a plus sign within its 
name, the cancellations would not be marked within the compiled file and the 
definitions for the function keys would not be cancelled within 4415-nl. 

Most diagnostic messages produced by tic during the compilation of the source file 
are preceded with the approximate line number and the name of the terminal 
currently being worked on. 

mkdir ... returned bad status 

The named directory could not be created. 

File does not start with terminal names in column one 

The first thing seen in the file, after comments, must be the list of terminal 
names. 

Token after a seek(2) not NAMES 

Somehow the file being compiled changed during the compilation. 

Not enough memory for usejist element 

or 
Out of memory 

Not enough free memory was available (malloc(3) failed). 

Can't open ... 

The named file could not be created.^ 

Error in writing ... 

The named file could not be written to. 

Can't link ... to ... 

A link failed. 

Error in re-reading compiled file ... 

The compiled file could not be read back in. 

Premature EOF 

The current entry ended prematurely. 

Backspaced off beginning of line 

This error indicates something wrong happened within tic. 

Unknown Capability - "..." 

The named invalid capability was found within the file. 

Wrong type used for capability "..." 

For example, a string capability was given a numeric value. 

Unknown token type 

Tokens must be followed by '©' to cancel, '/ for booleans, '#' for numbers, or 
'=' for strings. 

"...": bad term name 
or 
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Line ...: Illegal terminal name - "..." 

Terminal names must start with a letter or digit 

The given name was invalid. Names must not contain white space or slashes, 

and must begin with a letter or digit. 

"...": terminal name too long. 

An extremely long terminal name was found. 

"...": terminal name too short. 

A one-letter name was found. 

"..."filename too long, truncating to "..." 

The given name was truncated to 14 characters due to UNIX file name length 
limitations. 

"..." defined in more than one entry. Entry being used is "...". 
An entry was found more than once. 

Terminal name "..." synonym for itself 

A name was listed twice in the list of synonyms. 

At least one synonym should begin with a letter. 

At least one of the names of the terminal should begin with a letter. 

Illegal character - "..." 

The given invalid character was found in the input file. 

Newline in middle of terminal name 

The trailing comma was probably left off of the list of names. 

Missing comma 

A comma was missing. 

Missing numeric value 

The number was missing after a numeric capability. 

NULL string value « 

The proper way to say that a string capability does not exist is to cancel it. 

Very long string found. Missing comma? 
self-explanatory 

Unknown option. Usage is: 

An invalid option was entered. 

Too many file names. Usage is: 
self-explanatory 

"..." non-existant or permission denied 

The given directory could not be written into. 

"..."is not a directory 

self-explanatory 

"...": Permission denied 
access denied. 

"...": Not a directory 

tic wanted to use the given name as a directory, but it already exists as a file 

SYSTEM ERROR!! Fork failed!!! 
A/orfc(2)failed. 

Error in following up use-links. Either there is a loop in the links or they 
reference non-existant terminals. The following is a list of the entries 
involved: 
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A terminfo(A) entry with a use-name capability either referenced a non-existant 
terminal called name or name somehow referred back to the given entry. 
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TIME(1) 



NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



time - time a command 



time command 



The command is executed; after it is complete, time prints the elapsed time during the 
command, the time spent in the system, and the time spent in execution of the com- 
mand. Times are reported in seconds. 

The times are printed on standard error. 

See csh(l) for a description of the csh built-in command time, 
times(2). 



Stardent 1500/3000 



441 



Performance Measurement Utilities 



TIMEX(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
WARNING 



EXAMPLES 



TIMEX (1) 



timex - time a command; report process data and system activity 

timex [options] command 

The given command is executed; the elapsed time, user time and system time spent in 
execution are reported in seconds. Optionally, process accounting data for the com- 
mand and all its children can be listed or summarized, and total system activity dur- 
ing the execution interval can be reported. 

The output of timex is written on standard error. 

Options are: 

-p List process accounting records for command and all its children. Suboptions f, 
h, k, m, r, and t modify the data items reported. The options are as follows: 

-f Print the fork /exec flag and system exit status columns in the output. 

-h Instead of mean memory size, show the fraction of total available CPU 
time consumed by the process during its execution. This "hog factor" is 
computed as: 

(total CPU time)/(elapsed time). 

~k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor (user time/ (system-time + user-time). 

-t Show separate system and user CPU times. The number of blocks read 
or written and the number of characters transferred are always reported. 

~o Report the total number of blocks read or written and total characters 
transferred by command and all its children. 

-s Report total system activity (not just that due to command) that occurred during 
the execution interval of command. All the data items listed in sar(l) are 
reported. 

sar(l). 

Process records associated with command are selected from the accounting file 
/usr/adm/pacct by inference, since process genealogy is not available. Background 
processes having the same user-id, terminal-id, and execution time window will be 
spuriously included. 

A simple example: 

timex -ops sleep 60 
A terminal session of arbitrary complexity can be measured by timing a sub-shell: 
timex -opskmt sh 

session commands 
EOT 
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NAME 

SYNOPSIS 

DESCRIPTION 



touch - update access and modification times of a file 
touch [ -amc ] [ mmddhhmm[yy] ] files 



touch causes the access and modification times of each argument to be updated. The 
file name is created if it does not exist. If no time is specified (see date(D) the current 
time is used. The -a and -m options cause touch to update only the access or 
modification times respectively (default is -am). The -c option silently prevents 
touch from creating the file if it did not previously exist. 

The return code from touch is the number of files for which the times could not be 
successfully modified (including files that did not exist and were not created). 

SEE ALSO 

dated), utime(2). 
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NAME 
SYNOPSIS 



DESCRIPTION 



EXAMPLES 



TPUT(1) 



tput - initialize a terminal or query terminfo database 

tput [-Ttype] capname [parms ...] 
tput [-Ttype] init 
tput [-Ttype] reset 
tput [-Ttype] longname 

tput uses the terminfo(4) database to make the values of terminal-dependent capabili- 
ties and information available to the shell (see sh(l)), to initialize or reset the terminal, 
or return the long name of the requested terminal type, tput outputs a string if the 
attribute (capability name) is of type string, or an integer if the attribute is of type 
integer. If the attribute is of type boolean, tput simply sets the exit code (0 for TRUE if 
the terminal has the capability, 1 for FALSE if it does not), and produces no output. 
Before using a value returned on standard output, the user should test the exit code 
($?, see sh(D) to be sure it is 0. (See EXIT CODES and DIAGNOSTICS below.) For a 
complete list of capabilities and the capname associated with each, see terminfo(4). 

-Ttype indicates the type of terminal. Normally this option is unnecessary, 
because the default is taken from the environment variable TERM. If -T 
is specified, then the shell variables LINES and COLUMNS and the layer 
size (see layers(D) will not be referenced. 

capname indicates the attribute from the terminfo (4) database. 

parms If the attribute is a string that takes parameters, the arguments parms will 

be instantiated into the string. An all numeric argument will be passed 
to the attribute as a number. 

init If the terminfo(4) database is present and an entry for the user's terminal 

exists (see -Ttype, above), the following will occur: (1) if present, the 
terminal's initialization strings will be output (isl, is2, is3, if, iprog), (2) 
any delays (e.g., newline) specified in the entry will be set in the tty 
driver, (3) tabs expansion will be turned on or off according to the 
specification in the entry, and (4) if tabs are not expanded, standard tabs 
will be set (every 8 spaces). If an entry does not contain the information 
needed for any of the four above activities, that activity will silently be 
skipped. 

reset Instead of putting out initialization strings, the terminal's reset strings 

will be output if present (rsl, rs2, rs3, rf). If the reset strings are not 
present, but initialization strings are, the initialization strings will be out- 
put. Otherwise, reset acts identically to init. 

longname If the terminfo (A) database is present and an entry for the user's terminal 
exists (see -Ttype above), then the long name of the terminal will be put 
out. The long name is the last name in the first line of the terminal's 
description in the terminfo (4) database (see term(5)). 

tput init Initialize the terminal according to the type of terminal in the 

environmental variable TERM. This command should be 
included in everyone's .profile after the environmental variable 
TERM has been exported, as illustrated on the profile^) manual 
page. 
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TPUT(1) 



FILES 



SEE ALSO 



EXIT CODES 



DIAGNOSTICS 



tput-T5620 reset 
tput cup 

tput clear 
tput cols 
tput -T450 cols 
bold='tput smso' 
offbold='tput rmso' 



Reset an AT&T 5620 terminal, overriding the type of terminal in 
the environmental variable TERM. 

Send the sequence to move the cursor to row 0, column (the 
upper left corner of the screen, usually known as the "home" cur- 
sor position). 

Echo the clear-screen sequence for the current terminal. 

Print the number of columns for the current terminal. 

Print the number of columns for the 450 terminal. 



tput he 

tput cup 23 4 
tput longname 



Set the shell variables bold, to begin stand-out mode sequence, 
and off bold, to end standout mode sequence, for the current ter- 
minal. This might be followed by a prompt: 
echo "${bold}Please type in your name: ${offbold}\c" 

Set exit code to indicate if the current terminal is a hardcopy ter- 
minal. 
Send the sequence to move the cursor to row 23, column 4. 

Print the long name from the terminfo(4) database for the type of 
terminal specified in the environmental variable TERM. 



/usr/lib/terminfo/?/* 
/usr/include/curses.h 
/usr/include/term.h 
/usr/lib/tabset/ * 



compiled terminal description database 

curse$(3X) header file 

terminfo(4) header file 

tab settings for some terminals, in a format appropriate 

to be output to the terminal (escape sequences that set 

margins and tabs); for more information, see the "Tabs 

and Initialization" section of terminfo(4d 



stty (1), tabs (1), profile(4), terminfo(4). 

If capname is of type boolean, a value of is set for TRUE and 1 for FALSE. 

If capname is of type string, a value of is set if the capname is defined for this termi- 
nal type (the value of capname is returned on standard output); a value of 1 is set if 
capname is not defined for this terminal type (a null value is returned on standard out- 
put). 

If capname is of type integer, a value of is always set, whether or not capname is 
defined for this terminal type. To determine if capname is defined for this terminal 
type, the user must test the value of standard output. A value of -1 means that cap- 
name is not defined for this terminal type. 
Any other exit code indicates an error; see DIAGNOSTICS, below. 

tput prints the following error messages and sets the corresponding exit codes, 
exit 
code error message 

-1 {capname is a numeric variable that is not specified in the 

terminfo(4) database for this terminal type, e.g. 
tput -T450 lines and tput -T2621 xmc) 
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1 no error message is printed, see EXIT CODES, above. ■ 

2 usage error ^- 

3 unknown terminal type or no terminfo(4) database 

4 unknown terminfo(4) capability capname 
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NAME 

SYNOPSIS 

DESCRIPTION 



EXAMPLE 



SEE ALSO 
BUGS 



TR(1) 



tr - translate characters 

tr [ -cds ] [ stringl [ string2 ] ] 

tr copies the standard input to the standard output with substitution or deletion of 
selected characters. Input characters found in stringl are mapped into the 
corresponding characters of stringl . Any combination of the options -cds may be 
used: 

-c Complements the set of characters in stringl with respect to the universe of 

characters whose ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in stringl . 

-s Squeezes all strings of repeated output characters that are in stringl to sin- 

gle characters. 

The following abbreviation conventions may be used to introduce ranges of charac- 
ters or repeated characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run from character a 
to character z, inclusive. 

[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is considered octal; 
otherwise, n is taken to be decimal. A zero or missing n is taken to be huge; 
this facility is useful for padding stringl . 

The escape character \ may be used as in the shell to remove special meaning from 
any character in a string. In addition, \ followed by 1, 2, or 3 octal digits stands for 
the character whose ASCII code is given by those digits. 

The following example creates a list of all the words in filel one per line in filel, 
where a word is taken to be a maximal string of alphabetics. The strings are quoted 
to protect the special characters from interpretation by the shell; 012 is the ASCII code 
for newline. 

tr -cs "[A-Z][a-z] M "[\012*]" <filel >file2 
ed(l),sh(l),ascii(5). 
Will not handle ASCII NUL in stringl or stringl; always deletes NUL from input. 
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NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 



TRUE(1) 



true, false - provide truth values 

true 
false 



true does nothing, successfully. False does nothing, unsuccessfully. They are typi- 
cally used in input to sh(\) such as: 

while true 

do command done 



sh(l). 



true has exit status zero, false nonzero. 



( 



( 



c 



448 



Stardent 1500/3000 



Essential Utilities 



TSET(1) 

NAME 
SYNOPSIS 

DESCRIPTION 



TSET(1) 



tset,reset - terminal dependent initialization 

tset [ options ] [ -m [ident][test baudrate]:type ] ... [ type ] 
reset [ options ] [ -m [ident][test baudrate]:type ] ... [ type ] 

tset sets up your terminal when you first log in to a UNIX system. It does terminal 
dependent processing such as setting erase and kill characters, setting or resetting 
delays, sending any sequences needed to properly initialize the terminal, and the 
like. It first determines the type of terminal involved, and then does necessary initial- 
izations and mode settings. Type names for terminals may be found in the termcap{5) 
database. If a port is not wired permanently to a specific terminal (not hardwired) it 
will be given an appropriate generic identifier such as dialup. 

In the case where no arguments are specified, tset simply reads the terminal type out 
of the environment variable TERM and re-initializes the terminal. The rest of this 
manual concerns itself with mode and environment initialization, typically done 
once at login, and options used at initialization time to determine the terminal type 
and set up terminal modes. 

When used in a startup script (.profile for sh(l) users or .login for csh(l) users) it is 
desirable to give information about the type of terminal you will usually use on ports 
which are not hardwired. These ports are identified in jetcjttys as dialup or plugboard 
or network , etc. To specify what terminal type you usually use on these ports, the -m 
(map) option flag is followed by the appropriate port type identifier, an optional 
baud rate specification, and the terminal type. (The effect is to "map" from some 
conditions to a terminal type, that is, to tell tset "If I'm on this kind of port, guess that 
I'm on that kind of terminal".) If more than one mapping is specified, the first appli- 
cable mapping prevails. A missing port type identifier matches all identifiers. Any 
of the alternate generic names given in termcap may be used for the identifier. 

A baudrate is specified as with stty(l), and is compared with the speed of the diagnos- 
tic output (which should be the control terminal). The baud rate test may be any 
combination of: >, @, <, and !; @ means "at" and ! inverts the sense of the test. To 
avoid problems with metacharacters, it is best to place the entire argument to -m 
within "'" characters; users of csh(l) must also put a "\" before any "!" used here. 

Thus 

tset -m 'dialup>300:adm3a' -m dialup:dw2 -m 'plugboard:?adm3a' 

causes the terminal type to be set to an adm3a if the port in use is a dialup at a speed 
greater than 300 baud; to a dwl if the port is (otherwise) a dialup (i.e. at 300 baud or 
less). If the type finally determined by tset begins with a question mark, the user is 
asked if s/he really wants that type. A null response means to use that type; other- 
wise, another type can be entered which will be used instead. Thus, in the above 
case, the user will be queried on a plugboard port as to whether they are actually 
using an adm3a. 

If no mapping applies and a final type option, not preceded by a -m, is given on the 
command line then that type is used; otherwise the type found in the jetcjttys data- 
base will be taken to be the terminal type. This should always be the case for 
hardwired ports. 

It is usually desirable to return the terminal type, as finally determined by tset, and 
information about the terminal's capabilities to a shell's environment. This can be 
done using the - option; using the Bourne shell, sh(l): 
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export TERM; TERM= K tset - options..: 

or using the C shell, csh(l): 

setenv TERM "tset - options..: 

With csh it is preferable to use the following command in your .login file to initialize 
the TERM and TERMCAP environment variables at the same time. 

eval x tset -s options..: 

(The -s option will produce either C shell or Bourne shell commands based on the 
value of the SHELL environment variable.) 

It is also convenient to make an alias in your .cshrc: 

alias Tset 'set noglob; eval s tset -s \!* w 
This allows the command: 

Tset 2621 

to be invoked at any time to set the terminal and environment. Note to Bourne Shell 
users: It is not possible to get this aliasing effect with a shell script, because shell 
scripts cannot set the environment of their parent. (If a process could set its parent's 
environment, none of this nonsense would be necessary in the first place.) 

These commands cause tset to place the name of your terminal in the variables TERM 
and TERMCAP in the environment; see environ(5). NOTEs System V UNIX systems 
do not in general make use of the TERMCAP environment variable, since System V 
usually uses the compiled form of termcap called terminfo instead. It is useful, how- 
ever, to set TERMCAP if you are making any extensive use of 4.2 or 4.3 BSD utilities 
that do use termcap. £ 

Once the terminal type is known, tset engages in terminal driver mode setting. This 
normally involves sending an initialization sequence to the terminal, setting the sin- 
gle character erase (and optionally the line-kill (full line erase)) characters, and set- 
ting special character delays. Tab and newline expansion are turned off during 
transmission of the terminal initialization sequence. 

On terminals that can backspace but not overstrike (such as a CRT), and when the 
erase character is the default erase character ('#' on standard systems), the erase char- 
acter is changed to backspace (Control-H). 

The options are: 

~ec set the erase character to be the named character c on all terminals, the default 
being the backspace character on the terminal, usually A H. The character c can 
either be typed directly, or entered using the hat notation used here. 

-Ec set the erase character to c on all terminals except those which cannot backspace 
(e.g., a TTY 33). c defaults to control-H. 

-kc is similar to ~e but for the line kill character rather than the erase character; c 
defaults to A X (for purely historical reasons). The kill character is left alone if 
-k is not specified. The hat notation can also be used for this option. 

Ac is similar to -e but for the interrupt character rather than the erase character; c 
defaults to A C. The hat notation can also be used for this option. 

The name of the terminal finally decided upon is output on the standard out- 
put. This is intended to be captured by the shell and placed in the environment 
variable TERM. 



( 
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-s Print the sequence of csh or sh commands to initialize the environment vari- 
ables TERM and TERMCAP based on the name of the terminal finally decided 
upon. This option will produce either C shell or Bourne shell commands based 
on the value of the SHELL environment variable. 

-S — Similar to -s but outputs 2 strings suitable for use in csh .login files as fol- 
lows: 
set noglob 

setterm=('tset-S 

setenv TERM $term[l] 
setenv TERMCAP "$term[2]" 
unset term 
unset noglob 

-m map the system identified type to some user specified type. The mapping can 
be baud rate dependent. The syntax is: 

-m identifier [test baudrate] :type 
where: "identifier" can be any of the alternate generic names given in termcap 
(absence of an identifier matches any identifier); "test" may be any combina- 
tion of > = < ! @; "baudrate" is as with stty(l); "type" is the actual terminal 
type to use if the mapping condition is met. Multiple maps are scanned in order 
and the first match prevails. 

-A ask user for terminal type. 

-n On systems with the Berkeley 4BSD tty driver, specifies that the new tty driver 
modes should be initialized for this terminal. For a CRT, the CRTERASE and 
CRTKILL modes are set only if the baud rate is 1200 or greater. Not applicable 
to the Stardent 1500/3000. 

-v On virtual terminal systems, don't set up a virtual terminal. Otherwise tset will 
tell the operating system what kind of terminal you are on (if it is a known ter- 
minal) and fix up the output of -s to use virtual terminal sequences. Not appli- 
cable to the Stardent 1500/3000. 

-r report to user, in addition to other flags. 

-I suppresses transmitting terminal initialization strings. 

-Q suppresses printing the "Erase set to" and "Kill set to" messages. 

If tset is invoked as reset, it will set cooked and echo modes, turn off cbreak and raw 
modes, turn on newline translation, and restore special characters to a sensible state 
before any terminal dependent processing is done. Any special character that is 
found to be NULL or "-1" is reset to its default value. All arguments to tset may be 
used with reset. 

This is most useful after a program dies leaving a terminal in a funny state. You may 
have to type "<LF>reset<LF>" to get it to work since <CR> may not work in this state. 
Often none of this will echo. 



EXAMPLES 



In the csh, a user might typically put a call to tset in his .login file. The following 
example indicates that if the user has dialed in, he is on a vtlOO and if he's coming in 
through the network, his hardwired terminal type should be used. (If the user is 
working from a hardwired port, his terminal type will be set to $TERM.) The -s flag 
causes the environment variables TERM and TERMCAP to be set. The erase charac- 
ter is set to backspace ( A H). The "set noglob" is necessary to turn off csh's processing 
of special characters. (No "unset noglob" is necessary because the -s flag automati- 
cally produces one.) 



Stardent 1500/3000 451 



Essential Utilities 



TSET(1) TSET(1) 

set noglob; eval s tset -s -e -Q -m dialup:vtlOO -m network:$TERM s 

In addition, the csh user might like to include the following alias in his xshrc to allow 
easy resetting of the terminal type: 

alias Tset 'set noglob; eval s tset -s \!* w 

The rest of the examples all assume the Bourne shell and use the - option. If you use 
csh, use one of the variations described above. Note that a typical use of tset in a 
.profile or .login will also use the -e and -k options, and often the -n or -Q options 
as well. These options have not been included here to keep the examples small. 
(NOTE: Some of the examples given here appear to take up more than one line, for 
text processing reasons. When you type in real tset commands, you must enter them 
entirely on one line.) 

At the moment, you are on a 2621. This is suitable for typing by hand but not for a 
.profile, unless you are always on a 2621. 

export TERM; TERM= tset - 2621 s 

You have an hl9 at home which you dial up on, but your office terminal is hardwired 
and known in /etc/ttys. 

export TERM; TERM= tset — m dialup:M9 s 

You have a switch which connects everything to everything, making it nearly impos- 
sible to key on what port you are coming in on. You use a vtlOO in your office at 
9600 baud, and dial up to switch ports at 1200 baud from home on a 2621. Some- 
times you use someone else's terminal at work, so you want it to ask you to make 
sure what terminal type you have at high speeds, but at 1200 baud you are always on 
a 2621. Note the placement of the question mark, and the quotes to protect the 
greater than and question mark from interpretation by the shell. 

export TERM; TERM= tset — m 'switch>1200:?vtl00' -m , switch<=1200:262r 

All of the above entries will fall back on the terminal type specified in /etc/ttys if none 
of the conditions hold. The following entry is appropriate if you always dial up, 
always at the same baud rate, on many different kinds of terminals. Your most com- 
mon terminal is an adm3a. It always asks you what kind of terminal you are on, 
defaulting to adm3a. 

export TERM; TERM= tset - ?adm3a s 

If the file /etc/ttys is not properly installed and you want to key entirely on the baud 
rate, the following can be used: 

export TERM; TERM= tset - -m '>1200:vtl00' 2621 s 

Here is a fancy example to illustrate the power of tset and to hopelessly confuse any- 
one who has made it this far. You dial up at 1200 baud or less on a ConceptlOO, 
sometimes over switch ports and sometimes over regular dialups. You use various 
terminals at speeds higher than 1200 over switch ports, most often the terminal in 
your office, which is a vtlOO. However, sometimes you log in from the university 
you used to go to, over the ARPANET; in this case you are on an ALTO emulating a 
dm2500. You also often log in on various hardwired ports, such as the console, all of 
which are properly entered in /etc/ttys. You want your erase character set to control 
H, your kill character set to control U, and don't want tset to print the "Erase set to 
Backspace, Kill set to Control U" message. 

export TERM; TERM= s tset -e -k A U -Q - -m 'switch<=1200:conceptl00' -m 
'switch:?vtl00' -m dialupxonceptlOO -m arpanet:dm2500 s 
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FILES 

/etc/ttys port name to terminal type mapping database 

/etc/termcap terminal capability database 

SEE ALSO 

csh(l), environ(5), sh(l), stty(l), termcap(5) 

AUTHORS 

Eric Allman 
David Wasley 
Mark Horton 

BUGS 

The tset command is one of the first commands a user must master when getting 
started on a UNIX system. Unfortunately, it is one of the most complex, largely 
because of the extra effort the user must go through to get the environment of the 
login shell set. Something needs to be done to make all this simpler, either the 
login(l) program should do this stuff, or a default shell alias should be made, or a 
way to set the environment of the parent should exist. 

This program can't intuit personal choices for erase, interrupt and line kill characters, 
so it leaves these set to the local system standards. 
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NAME 

SYNOPSIS 

DESCRIPTION 



DIAGNOSTICS 



TSORT(T) 



tsort - topological sort 

tsort [file] 

The tsort command produces on the standard output a totally ordered list of items 
consistent with a partial ordering of items mentioned in the input file. If no file is 
specified, the standard input is understood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of 
different items indicate ordering. Pairs of identical items indicate presence, but not 
ordering. 

Odd data: there is an odd number of fields in the input file. 
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NAME 

SYNOPSIS 

DESCRIPTION 



DIAGNOSTICS 



tty - get the name of the terminal 
tty[-l][-s] 

tty prints the path name of the user's terminal. 

-1 prints the synchronous line number to which the user's terminal is connected, if 
it is on an active synchronous line. 

-s inhibits printing of the terminal path name, allowing one to test just the exit 
code. 

EXIT CODES 
2 if invalid options were specified, 

if standard input is a terminal, 

1 otherwise. 

"not on an active synchronous line" if the standard input is not a synchronous termi- 
nal and -1 is specified, 
"not a tty" if the standard input is not a terminal and -s is not specified. 
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NAME 

SYNOPSIS 

DESCRIPTION 



uadmin - administrative control 
/etc/uadmin cmd fen 



C 



The uadmin command provides control for basic administrative functions. This com- 
mand is tightly coupled to the system administration procedures and is not intended 
for general use. It may be invoked only by the superuser. 

The arguments cmd (command) and fen (function) are converted to integers and 
passed to the uadmin(2) system call. 

SEE ALSO 

uadmin(2) 



( 



( 



456 Stardent 1500/3000 



Essential Utilities 



UL(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



UL(1) 



ul - do underlining 

ul [ -i ] [ -t terminal ] [ name ... ] 

ul reads the named files (or standard input if none are given) and translates 
occurrences of underscores to the sequence which indicates underlining for the ter- 
minal in use, as specified by the environment variable TERM. The -t option over- 
rides the terminal kind specified in the environment. The file /etc/termcap is read to 
determine the appropriate sequences for underlining. If the terminal is incapable of 
underlining, but is capable of a standout mode then that is used instead. If the termi- 
nal can overstrike, or handles underlining automatically, ul degenerates to cat(l). If 
the terminal cannot underline, underlining is ignored. 

The -i option causes ul to indicate underlining onto by a separate line containing 
appropriate dashes '-'; this is useful when you want to look at the underlining which 
is present in an nroff output stream on a crt-terminal. 

man(l), nroff(l), colcrt(l) 

nroff usually outputs a series of backspaces and underlines intermixed with the text 
to indicate underlining. No attempt is made to optimize the backward motion. 
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NAME 

SYNOPSIS 

DESCRIPTION 



UMASK(1) 



umask - set file-creation mode mask 



umask [ ooo ] 



SEE ALSO 



The user file-creation mode mask is set to ooo. The three octal digits refer to 
read/ write/execute permissions for owner, group, and others, respectively (see 
chmod(2) and umask{2)). The value of each specified digit is subtracted from the 
corresponding "digit" specified by the system for the creation of a file (see creat(2)). 
For example, umask 022 removes group and others write permission (files normally 
created with mode 777 become mode 755; files created with mode 666 become mode 
644). 

If ooo is omitted, the current value of the mask is printed. 

umask is recognized and executed by the shell. 

umask can be included in the user's .profile (see profiled)) and invoked at login to 
automatically set the user's permissions on files or directories created. 

chmod(l), sh(l), chmod(2), creat(2), umask(2), profile(4). 
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NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 



UNAME(1) 



uname - print name of current UNIX system 

uname [ -snrvma ] 
uname [ -S system name ] 

uname prints the current system name of the UNIX system on the standard output 
file. It is mainly useful to determine which system one is using. The options cause 
selected information returned by uname(2) to be printed: 

-s print the system name (default). 

-n print the nodename (the nodename is the name by which the system is known 
to a communications network). 

-r print the operating system release. 

-v print the operating system version. 

-m print the machine hardware name. 

-a print all the above information. 

The system name and the nodename may be changed by specifying a system name 
argument to the -S option. The system name argument is restricted to 8 characters. 
Only the super-user is allowed this capability. 

uname(2). 
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NAME 

SYNOPSIS 

DESCRIPTION 



Source Code Control System Utilities 



SEE ALSO 
DIAGNOSTICS 



UNGET(1) 



unget - undo a previous get of an SCCS file 

unget [-rSID] [-s] [-n] files 

unget undoes the effect of a get -e done prior to creating the intended new delta. If a 
directory is named, unget behaves as though each file in the directory were specified 
as a named file, except that non-SCCS files and unreadable files are silently ignored. 
If a name of - is given, the standard input is read with each line being taken as the 
name of an SCCS file to be processed. 

Keyletter arguments apply independently to each named file. 

-rSID Uniquely identifies which delta is no longer intended. (This 

would have been specified by get as the "new delta"). The use of 
this keyletter is necessary only if two or more outstanding gets for 
editing on the same SCCS file were done by the same person 
(login name). A diagnostic results if the specified SID is ambigu- 
ous, or if it is necessary and omitted on the command line. 

Suppresses the printout, on the standard output, of the intended 
delta's SID. 

Causes the retention of the gotten file which would normally be 
removed from the current directory. 



-s 



-n 



c 



delta(l), get(l), help(l), sact(l). 
Use help(l) for explanations. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 
DIAGNOSTICS 

BUGS 



AUTHOR 



UNIFDEF (1) 



unifdef - remove ifdef ed lines 

unif def [ -t -1 -c -Dsym -Usym -idsym -iusym ] ... [ file ] 

unifdef 'is useful for removing ifdef ed lines from a file while otherwise leaving the file 
alone, unifdef 'is like a stripped-down C preprocessor: it is smart enough to deal with 
the nested ifdefs, comments, single and double quotes of C syntax so that it can do its 
job, but it doesn't do any including or interpretation of macros. Neither does it strip 
out comments, though it recognizes and ignores them. You specify which symbols 
you want defined -Dsym or undefined -Usym and the lines inside those ifdefs will be 
copied to the output or removed as appropriate. The ifdef, ifndef, else, and endif 
lines associated with sym will also be removed. Ifdefs involving symbols you don't 
specify are untouched and copied out along with their associated ifdef, else, and 
endif lines. If an ifdef X occurs nested inside another ifdef X, then the inside ifdef is 
treated as if it were an unrecognized symbol. If the same symbol appears in more 
than one argument, only the first occurrence is significant. 

The -1 option causes unifdef to replace removed lines with blank lines instead of 
deleting them. 

If you use ifdefs to delimit non-C lines, such as comments or code which is under 
construction, then you must tell unifdef which symbols are used for that purpose so 
that it won't try to parse for quotes and comments in those ifdef'ed lines. You 
specify that you want the lines inside certain ifdefs to be ignored but copied out with 
-idsym and -iusym similar to -Dsym and -Usym above. 

If you want to use unifdef for plain text (not C code), use the -t option. This makes 
unifdef refrain from attempting to recognize comments and single and double quotes. 

unifdef copies its output to stdout and will take its input from stdin if no file argument 
is given. If the -c argument is specified, then the operation of unifdef is comple- 
mented, i.e. the lines that would have been removed or blanked are retained and vice 
versa. 

diff(l) 

Premature EOF, inappropriate else or endif. 

Exit status is if output is exact copy of input, 1 if not, 2 if trouble. 

Does not know how to deal with cpp consructs such as 
#if defined(X) I I defined(Y) 

Dave Yost 
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NAME 

uniq - report repeated lines in a file 

uniq [ -udc [ +n ] [ -n ] ] [ input [output ] ] 

uniq reads the input file comparing adjacent lines. In the normal case, the second 
and succeeding copies of repeated lines are removed; the remainder is written on the 
output file. Input and output should always be different. Note that repeated lines 
must be adjacent in order to be found; see sort(l). If the -u flag is used, just the lines 
that are not repeated in the original file are output. The -d option specifies that one 
copy of just the repeated lines is to be written. The normal mode output is the union 
of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in default style 
but with each line preceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

-n The first n fields together with any blanks before each are ignored. A field is 

defined as a string of non-space, non-tab characters separated by tabs and 
spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before characters. 



C 



SEE ALSO 

comm(l), sort(l). 



( 
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NAME 

SYNOPSIS 

DESCRIPTION 



units - conversion program 
units 

units converts quantities expressed in various standard scales to their equivalents in 
other scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units optionally preceded 
by a numeric multiplier. Powers are indicated by suffixed positive integers, division 
by the usual sign: 

You have: 15 lbs f orce/in2 
You want: atm 

* 1.020689e+00 
/ 9.797299e-01 

units only does multiplicative scale changes; thus it can convert Kelvin to Rankine, 
but not Celsius to Fahrenheit. Most familiar units, abbreviations, and metric prefixes 
are recognized, together with a generous leavening of exotica and a few constants of 
nature including: 

pi ratio of circumference to diameter, 

c speed of light, 

e charge on an electron, 

g acceleration of gravity, 

force same as g, 

mole Avogadro's number, 

water pressure head per unit height of water, 

au astronomical unit. 

Pound is not recognized as a unit of mass; lb is. Compound names are run together, 
(e.g., lightyear). British units that differ from their U.S. counterparts are prefixed 
thus: brgallon. For a complete list of units, type: 

cat /usr/lib/unittab 



FILES 

/usr/lib/unittab 
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NAME 

uptime - show how long system has been up 

SYNOPSIS 

uptime 

DESCRIPTION 

uptime prints the current time, the length of time the system has been up, and the 
average number of jobs in the run queue over the last 1, 5 and 15 minutes. It is, 
essentially, the first line of a w(l) command. 

FILES 

/unix system name list 

SEE ALSO 

w(l) 



C 



( 



464 Stardent 1500/3000 



Terminal Information Utilities 



USERS(1) USERS (1) 

NAME 

users - compact list of users who are on the system 

SYNOPSIS 

users 

DESCRIPTION 

users lists the login names of the users currently on the system in a compact, one-line 



FILES 
SEE ALSO 



format. 

/etc/utmp 

who(l) 
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UUCHECK (1M) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
BUGS 



UUCHECK (1M) 



uucheck - check the uucp directories and permissions file 

/usr/lib/uucp/uucheck [ -v ] [ -x debugjevel ] 

uucheck checks for the presence of the uucp system required files and directories. 
Within the uucp makefile, it is executed before the installation takes place. It also 
checks for some obvious errors in the Permissions file (/usr/lib/uucp/Fermissions). 
When executed with the -v option, it gives a detailed explanation of how the uucp 
programs will interpret the Permissions file. The -x option is used for debugging. 
dehug-option is a single digit in the range 1-9; the higher the value, the greater the 
detail. 

Note that uucheck can only be used by the super-user or uucp. 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

uucico(lM), uucp(lC), uusched(lM), uustat(lC), uux(lC). 

The program does not check file/directory modes or some errors in the Permissions 
file such as duplicate login or machine name. 
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UUCICO(1M) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



uucico - file transport program for the uucp system 

/usr/lib/uucp/uucico [ -r role_number ] [ -x debugjevel ] 
[ -i interface ] [ -d spool_directory ] -s system_name 

uucico is the file transport program for uucp work file transfers. Role numbers for the 
-r are the digit 1 for master mode or for slave mode (default). The -r option should 
be specified as the digit 1 for master mode when uucico is started by a program or 
cron. Uux and uucp both queue jobs that will be transferred by uucico. It is normally 
started by the scheduler, uusched , but can be started manually; this is done for 
debugging. For example, the shell Uutry starts uucico with debugging turned on. A 
single digit must be used for the -x option with higher numbers for more debugging. 

The -i option defines the interface used with uucico. This interface only affects slave 
mode. Known interfaces are UNIX (default), TLI (basic Transport Layer Interface), 
and TLIS (Transport Layer Interface with STREAMS modules, read/write). 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Devconfig 

/usr/lib/uucp/Sysfiles 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

cron(lM), uucp(lC), uusched(lM), uustat(lC), uutry(lM), uux(lC). 
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NAME 
SYNOPSIS 

DESCRIPTION 



BasJcNetwori<ira 



UUCLEANUP(IM) 



uucleanup - uucp spool directory clean-up 

/usr/lib/uucp/uucleanup [ -Ctime ] [ -Wtime ] [ -Xtime ] [ -mstring ] 
[ -otime ] [ -ssystern ] 

uucleanup will scan the spool directories for old files and take appropriate action to 
remove them in a useful way: 

Inform the requestor of send/receive requests for systems that can not be 
reached. 

Return mail, which cannot be delivered, to the sender. 

Delete or execute rnews for rnews type files (depending on where the news 
originated — locally or remotely). 

Remove all other files. 

In addition, there is provision to warn users of requests that have been waiting for a 
given number of days (default 1). Note that uucleanup will process as if all option 
times were specified to the default values unless time is specifically set. 

The following options are available. 

-Ctime Any C. files greater or equal to time days old will be removed with 
appropriate information to the requestor, (default 7 days) 

-Dtime Any D. files greater or equal to time days old will be removed. An 
attempt will be made to deliver mail messages and execute rnews when 
appropriate, (default 7 days) 

-Wtime Any C. files equal to time days old will cause a mail message to be sent to 
the requestor warning about the delay in contacting the remote. The mes- 
sage includes the JOBID, and in the case of mail, the mail message. The 
administrator may include a message line telling whom to call to check 
the problem (-m option), (default 1 day) 

-Xtime Any X. files greater or equal to time days old will be removed. The D. 
files are probably not present (if they were, the X. could get executed). 
But if there are D. files, they will be taken care of by D. processing, 
(default 2 days) 

-mstring This line will be included in the warning message generated by the -W 
option. 

-otime Other files whose age is more than time days will be deleted, (default 2 
days) The default line is "See your local administrator to locate the prob- 
lem". 

-ssystern Execute for system spool directory only. 

-xdebugjevel 

The -x debug level is a single digit between and 9; higher numbers give more 
detailed debugging information. (If uucleanup was compiled with -DSMALL, 
no debugging output will be available.) 

This program is typically started by the shell uudemon.cleanup, which should be 
started by cron(lM). 



( 
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/usr/lib/uucp directory with commands used by uucleanup internally 

/usr/spool/uucp spool directory 

SEE ALSO 

cron(lM). uucp(lC), uux(lC). 
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DESCRIPTION 
uucp 



uucp, uulog, uuname - UNIX-to-UNIX system copy 

uucp [ options ] source-files destination-file 
uulog [ options ] -s system 
uulog [ options ] system 
uulog [ options ] -f system 
uuname [ -1 ] [ -c ] 



uucp copies files named by the source-file arguments to the destination-file argument. 
A file name may be a path name on your machine, or may have the form: 

system-name!path-name 

where system-name is taken from a list of system names that uucp knows about. The 
system-name may also be a list of names such as 

system-name!system-name!...!system-name!path-name 

in which case an attempt is made to send the file via the specified route, to the desti- 
nation. See WARNINGS and BUGS below for restrictions. Care should be taken to 
ensure that intermediate nodes in the route are willing to foward information (see 
WARNINGS below for restrictions). 

The shell metacharacters ?, * and [...] appearing in path-name will be expanded on 
the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by '-user where user is a login name on the 
specified system and is replaced by that user's login directory; 

(3) a path name preceded by ^/destination where destination is appended to 
/usr/spool/uucppublic; (NOTE: This destination will be treated as a file 
name unless more than one file is being transfered by this request or the 
destination is already a directory. To ensure that it is a directory, follow 
the destination with a '/'• For example ~/dan/ as the destination will 
make the directory /usr/spool/uucppublic/dan if it does not exist and 
put the requested file(s) in that directory). 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy will fail. If the 
destination-file is a directory, the last part of the source-file name is used. 

uucp preserves execute permissions across the transmission and gives 0666 read and 
write permissions (see chmod (2)). 

The following options are interpreted by uucp: 

-c Do not copy local file to the spool directory for transfer to the remote 

machine (default). 

-C Force the copy of local files to the spool directory for transfer. 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 
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uulog 



uuname 



FILES 



SEE ALSO 
WARNINGS 



-ggrade 
-J 

-m 

-miser 
-r 

-sfile 



Grade is a single letter/number; lower ascii sequence characters will cause 
the job to be transmitted earlier during a particular conversation. 

Output the job identification ASCII string on the standard output. This 
job identification can be used by uustat to obtain the status or terminate a 
job. 

Send mail to the requester when the copy is completed. 

Notify user on the remote system that a file was sent. 

Do not start the file transfer, just queue the job. 

Report status of the transfer to file. Note that the file must be a full path 
name. 



-xdebugjevel 

Produce debugging output on standard output. The debugjevel is a 
number between and 9; higher numbers give more detailed information. 
(Debugging will not be available if uucp was compiles with -DSMALL.) 



a file 



uulog queries a log file of uucp or uuxqt transactions in 
/usr/spool/uucp/Xog/uucico/sys^m^r/usr/spool/uucp/Xog/uuxqt/si/sfem. 

The options cause uulog to print logging information: 

-ssys Print information about file transfer work involving system sys. 

-isystem Does a "tail -f" of the file transfer log for system. (You must hit BREAK to 
exit this function.) Other options used in conjunction with the above: 

-x Look in the uuxqt log file for the given system. 

-number Indicates that a "tail" command of number lines should be executed. 

uuname lists the names of systems known to uucp. The -c option returns the names 
of systems known to cu. (The two lists are the same, unless your machine is using 
different Systems files for cu and uucp. See the Sysfiles file.) The -1 option returns the 
local system name. 

/usr/spool/uucp spool directories 

/usr/spool/uucppublic/*public directory for receiving and 

sending (/usr/spool/uucppublic) 
/usr/lib/uucp/* other data and program files 

chmod(2), mail(l), uustat(lC), uux(lC), uuxqt(lM). 

The domain of remotely accessible files can (and for obvious security reasons, usually 
should) be severely restricted. You will very likely not be able to fetch files by path 
name; ask a responsible person on the remote system to send them to you. For the 
same reasons you will probably not be able to send files to arbitrary path names. As 
distributed, the remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to -/). 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. Receiving mul- 
tiple files specified by special shell characters ? * [...] will not activate the -m 
option. 
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The forwarding of files through other systems may not be compatible with the previ- I 

ous version of uucp. If forwarding is used, all systems in the route must have the ^ 

same version of uucp, 

BUGS 

Protected files and files that are in protected directories that are owned by the 
requestor can be sent by uucp. However, if the requestor is root, and the directory is 
not searchable by "other" or the file is not readable by "other", the request will fail. 
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NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 
BUGS 



uuencode, uudecode - encode/ decode a binary file for transmission via mail 

uuencode [ source ] remotedest I mail sysl!sys2L!decode 
uudecode [ file ] 

uuencode and uudecode are used to send a binary file via uucp (or other) mail. This 
combination can be used over indirect mail links even when uusend (1C) is not avail- 
able. 

uuencode takes the named source file (default standard input) and produces an 
encoded version on the standard output. The encoding uses only printing ASCII 
characters, and includes the mode of the file and the remotedest for recreation on the 
remote system. 

uudecode reads an encoded file, strips off any leading and trailing lines added by 
mailers, and recreates the original file with the specified mode and name. 

The intent is that all mail to the user "decode" should be filtered through the 
uudecode program. This way the file is created automatically without human inter- 
vention. This is possible on the uucp network by either using sendmail or by making 
rmail be a link to Mail instead of mail. In each case, an alias must be created in a mas- 
ter file to get the automatic invocation of uudecode. 

If these facilities are not available, the file can be sent to a user on the remote machine 
who can uudecode it manually. 

The encode file has an ordinary text form and can be edited by any text editor to 
change the mode or remote name. 

atob(n), uusend(lC), uucp(lC), uux(lC), mail(l), uuencode(4) 

The file is expanded by 35% (3 bytes become 4 plus control information) causing it to 
take longer to transmit. 

The user on the remote system who is invoking uudecode (often uucp) must have 
write permission on the specified file. 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



BUGS 



UUGETTY(IM) 



uugetty - set terminal type, modes, speed, and line discipline 

/usr/lib/uucp/getty [ -h ] [ -t timeout ] [ -r ] line 
[ speed [ type [ linedisc ] ] ] 
/usr/lib/uucp/getty -c file 

uugetty is identical to gettyQM) but changes have been made to support using the 
line for uucico, cu, and ct; that is, the line can be used in both directions. The uugetty 
will allow users to login, but if the line is free, uucico, cu, or ct can use it for dialing 
out. The implementation depends on the fact that uucico, cu, and ct create lock files 
when devices are used. When the "openQ" returns (or the first character is read when 
-r option is used), the status of the lock file indicates whether the line is being used 
by uucico, cu, ct, or someone trying to login. Note that in the -r case, several 
<carriage-return> characters may be required before the login message is output. 
The human users will be able to handle this slight inconvenience. Uucico trying to 
login will have to be told by using the following login script: 

"" \r\d\r\d\r\d\r in:-in: ... 

where the ... is whatever would normally be used for the login sequence. 

An entry for an intelligent modem or direct line that has a uugetty on each end must 
use the -r option. (This causes uugetty to wait to read a character before it puts out 
the login message, thus preventing two uugettys from looping.) If there is a uugetty 
on one end of a direct line, there must be a uugetty on the other end as well. Here is 
an /etc/inittab entry using uugetty on an intelligent modem or direct line: 

30:2:respawn:/usr/lib/uucp/uugetty -r -t 60 ttyl2 1200 

/etc/gettydefs 
/etc/issue 

ct(lC), cu(lC), getty(lM), gettydefs(4), init(lM), inittab(4), ioctl(2), login(l), tty(7), 
uucico(lM). 

Ct will not work when uugetty is used with an intelligent modem such as penril or 
ventel. 
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NAME 

SYNOPSIS 

DESCRIPTION 



UUSCHED(IM) 



FILES 



SEE ALSO 



uusched - the scheduler for the uucp file transport program 

/usr/lib/uucp/uusched [ -x debugjevel ] [ -u debugjevel ] 

uusched is the uucp file transport scheduler. It is usually started by the daemon 
uudemon.hour that is started by cron(lM) from an entry in /usr/spool/cron/crontab: 

39 * * * * /bin/su uucp -c Vusr/lib/uucp/uudemon.hour > /dev/null" 

The two options are for debugging purposes only; -x debugjevel will output debug- 
ging messages from uusched and -u debugjevel will be passed as -x debugjevel to 
uucico. The debugjevel is a number between and 9; higher numbers give more 
detailed information. 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/ spool/uucppublic/ * 

cron(lM), uucico(lM), uucp(lC), uustat(lC), uux(lC). 
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SYNOPSIS 



DESCRIPTION 



UUSTAT(1C) 



uustat - uucp status inquiry and job control 

uustat [-a] 

uustat [-m] 

uustat [-p] 

uustat [-q] 

uustat [ -kjobid ] 

uustat [ -tjobid ] 

uustat [ -ssystem ] [ -u user ] 

uustat will display the status of, or cancel, previously specified uucp commands, or 
provide general status on uucp connections to other systems. Only one of the follow- 
ing options can be specified with uustat per command execution: 

-a Output all jobs in queue. 

-m Report the status of accessibility of all machines. 

-p Execute a "ps -flp" for all the process-ids that are in the lock files. 

-q List the jobs queued for each machine. If a status file exists for the 

machine, its date, time and status information are reported. In addition, if 
a number appears in ( ) next to the number of C or X files, it is the age in 
days of the oldest C/X. file for that system. The Retry field represents 
the number of hours until the next possible call. The Count is the number 
of failure attempts. NOTE: for systems with a moderate number of out- 
standing jobs, this could take 30 seconds or more of real-time to execute. 
As an example of the output produced by the -q option: 

eagle 3C 04/07-11:07 NO DEVICES AVAILABLE 

mh3bs3 2C 07/07-10:42 SUCCESSFUL 

This output tells how many command files are waiting for each system. 
Each command file may have zero or more files to be sent (zero means to 
call the system and see if work is to be done). The date and time refer to 
the previous interaction with the system followed by the status of the 
interaction. 

Kill the uucp request whose job identification is jobid. The killed uucp 
request must belong to the person issuing the uustat command unless one 
is the super-user. 

Rejuvenate jobid. The files associated with jobid are touched so that their 
modification time is set to the current time. This prevents the cleanup 
daemon from deleting the job until the jobs modification time reaches the 
limit imposed by the deamon. 

Either or both of the following options can be specified with uustat: 

-ssys Report the status of all uucp requests for remote system sys. 



-kjobid 
-tjobid 



-uuser 



Report the status of all uucp requests issued by user. 
Output for both the -s and ~u options has the following format: 



eaglenOOOO 

eagleNlbd7 

eagleClbd8 



4/07-11:01:03 
4/07-11:07 
4/07-11:07 
4/07-11:07 



(POLL) 
S eagle 

S eagle 

S eagle 



dan 522 /usr/dan/A 
dan 59 D.3b2al2ce4924 
dan rmail mike 



( 



( 



( 



With the above two options, the first field is the jobid of the job. This is followed by 



476 



Stardent 1500/3000 



Basic Networking Utilities 



UUSTAT(1C) UUSTAT(1C) 

the date/time. The next field is either an 'S' or 'R' depending on whether the job is to 
send or request a file. This is followed by the user-id of the user who queued the job. 
The next field contains the size of the file, or in the case of a remote execution ( rmail 
- the command used for remote mail), the name of the command. When the size 
appears in this field, the file name is also given. This can either be the name given by 
the user or an internal name (e.g., D.3b2alce4924) that is created for data files associ- 
ated with remote executions (rmail in this example). 

When no options are given, uustat outputs the status of all uucp requests issued by 
the current user. 



FILES 
SEE ALSO 



/usr/ spool/uucp/ * spool directories 
uucp(lC). 
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uuto, uupick - public UNIX-to-UNIX system file copy 

uuto [ options ] source-files destination 
uupick [ -s system ] 

uuto sends source-files to destination, uuto uses the uucp(lC) facility to send files, 
while it allows the local system to control the file access. A source-file name is a path 
name on your machine. Destination has the form: 

systemluser 

where system is taken from a list of system names that uucp knows about (see 
uuname). User is the login name of someone on the specified system. 

Two options are available: 

-p Copy the source file into the spool directory before transmission, 

-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on system, where 
PUBDIR is a public directory defined in the uucp source. By default this directory is 
/usr/spool/uucppublic. Specifically the files are sent to 

PUBDIR/ receive/ user /mysystem/ files. 

The destined recipient is notified by mail(l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the user. Specifically, uupick 
searches PUBDIR for files destined for the user. For each entry (file or directory) 
found, the following message is printed on the standard output: 

from systemx [file file-name] [dir dirname] ? 

Uupick then reads a line from the standard input to determine the disposition of the 
file: 

<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir. If dir is not specified as a 

complete path name (in which $HOME is legitimate), a destination 
relative to the current directory is assumed. If no destination is 
given, the default is the current directory. 

Same as m except moving all the files sent from system . 

Print the content of the file. 

Stop. 

Same as q. 

Escape to the shell to do command. 

* Print a command summary. 

Uupick invoked with the -ssystem option will only search the PUBDIR for files sent 
from system . 



a [ dir ] 
P 

q 

EOT (control-d) 
Icommand 



c 



c 



FILES 



PUBDIR /usr/ spool/uucppublic public directory 
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SEE ALSO 

mail(l), uucleanup(lM), uucp(lC), uustat(lC), uux(lC). 

WARNINGS 

In order to send files that begin with a dot (e.g., .profile) the files must by qualified 
with a dot. For example: .profile, .prof*, .profil? are correct; whereas *prof*, ?profile 
are incorrect. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



UUTRY(tM) 



Uutry - try to contact remote system with debugging on 

/usr/lib/uucp/Uutry [ -x debugjevel ] [ -r ] system jrtame 

Uutry is a shell that is used to invoke uucico to call a remote site. Debugging is 
turned on (default is level 5); -x will override that value. The -r overrides the retry 
time in /usr/spool/uucp/.status. The debugging output is put in file 
/tmp/system_name. A tail -f of the output is executed. A <DELETE> or <BREAK> 
will give control back to the terminal while the uucico continues to run, putting its 
output in /tmp/ systemjiame. 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

/tmp/system_name 

uucico(lM), uucp(lC), uux(lC). 



c 



( 



C 
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NAME 

SYNOPSIS 

DESCRIPTION 



UUX(1C) 



uux - UNIX-to-UNIX system command execution 

uux [ options ] command-string 

uux will gather zero or more files from various systems, execute a command on a 
specified system and then send standard output to a file on a specified system. 

NOTE: For security reasons, most installations limit the list of commands executable 
on behalf of an incoming request from uux, permiting only the receipt of mail (see 
maiUD). (Remote execution permissions are defined in /usr/lib/uucp/Permissions.) 

The command-string is made up of one or more arguments that look like a shell com- 
mand line, except that the command and file names may be prefixed by system-namel 
A null system-name is interpreted as the local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on the specified 
system and is replaced by that user's login directory; 

(3) anything else is prefixed by the current directory. 
As an example, the command 

uux "!diff usg!/usr/dan/filel pwba!/a4/dan/file2 > !~/dan/file.diff" 

will get the filel and file! files from the "usg" and "pwba" machines, execute a diffQ) 
command and put the results in file.diff in the local PUBDIR/dan/ directory. 

Any special shell characters such as <>;l should be quoted either by quoting the 
entire command-string, or quoting the special characters as individual arguments. 

uux will attempt to get all files to the execution system. For files that are output files, 
the file name must be escaped using parentheses. For example, the command 

uux a!cut -fl b!/usr/file \(c!/usr/file\) 

gets /usr/file from system "b" and sends it to system "a", performs a cut command 
on that file and sends the result of the cut command to system "c". 

uux will notify you if the requested command on the remote system was disallowed. 
This notification can be turned off by the -n option. The response comes by remote 
mail from the remote machine. 

The following options are interpreted by uux: 

The standard input to uux is made the standard input to the command- 
string. 

-aname Use name as the user identification replacing the initiator user-id. 
(Notification will be returned to the user.) 

-b Return whatever standard input was provided to the uux command if the 

exit status is non-zero. 

-c Do not copy local file to the spool directory for transfer to the remote 

machine (default). 

-C Force the copy of local files to the spool directory for transfer. 

-ggrade Grade is a single letter/number; lower ASCII sequence characters will 
cause the job to be transmitted earlier during a particular conversation. 
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£L 



FILES 



SEE ALSO 
WARNINGS 



BUGS 



UUX(1C) 



-J 



-n 

-r 

sfile 



Output the jobid ASCII string on the standard output which is the job 
identification. This job identification can be used by uustat to obtain the 
status or terminate a job. 

Do not notify the user if the command fails. 

Same as -: The standard input to uux is made the standard input to the 
command-string. 

Do not start the file transfer, just queue the job. 

Report status of the transfer in file, 
-xdebugjevel 

Produce debugging output on the standard output. The debug Jeael is a 

number between and 9; higher numbers give more detailed information. 
-z Send success notification to the user. 

/usr/lib/uucp/spool spool directories 

/usr/lib/uucp/Permissions 

remote execution permissions 
/usr/lib/uucp/* other data and programs 

cut(l), mail(l), uucp(lC), uustat(lC). 

Only the first command of a shell pipeline may have a system-namel. All other com- 
mands are executed on the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. 
The shell tokens « and » are not implemented. 

The execution of commands on remote systems takes place in an execution directory 
known to the uucp system. All files required for the execution will be put into this 
directory unless they already reside on that machine. Therefore, the simple file name 
(without path or machine reference) must be unique within the uux request. The fol- 
lowing command will NOT work: 

uux "aldiff b!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 
but the command 

uux "aldiff a!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff 
will work. (If diff is a permitted command.) 

Protected files and files that are in protected directories that are owned by the 
requestor can be sent in commands using uux. However, if the requestor is root, and 
the directory is not searchable by "other", the request will fail. 



( 



( 



( 
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SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



UUXQT(1M) 



uuxqt - execute remote command requests 

/usr/lib/uucp/uuxqt [ -s system ] [ -x debugjevel ] 

uuxqt is the program that executes remote job requests from remote systems gen- 
erated by the use of the uux command. (Mail uses uux for remote mail requests). 
uuxqt searches the spool directories looking for X. files. For each X. file, uuxqt checks 
to see if all the required data files are available and accessible, and file commands are 
permitted for the requesting system. The Permissions file is used to validate file 
accessibility and command execution permission. 

There are two environment variables that are set before the uuxqt command is exe- 
cuted: 

UU_MACHINE is the machine that sent the job (the previous one). 

UUJJSER is the user that sent the job. 

These can be used in writing commands that remote systems can execute to provide 
information, auditing, or restrictions. 

The -x debug Jevel is a single digit between and 9. Higher numbers give more 
detailed debugging information. 

/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 

mail(l), uucico(lM), uucp(lC), uustat(lC), uux(lC). 
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NAME 
SYNOPSIS 

DESCRIPTION 



SEE ALSO 



VACATION (1) 



vacation - return "I am on vacation" indication 

vacation -I 
vacation user 

vacation returns a message to the sender of a message telling that you are on vacation. 
The intended use is in a .forward file. For example, your .forward file might have: 

\eric, " I vacation eric" 

which would send messages to you (assuming your login name was eric) and send a 
message back to the sender. 

vacation expects a file .vacation.msg in your home directory containing a message to be 
sent back to each sender. It should be an entire message (including headers). For 
example, it might say: 

From: eric@ucbmonet.Berkeley.EDU (Eric Allman) 
Subject: I am on vacation 
Delivered-By-The-Graces-Of : the Vacation program 

I am on vacation until July 22. If you have something urgent, 
please contact Joe Kalash <kalash@ucbingres.Berkeley.EDU>. 
—eric 

This message will only be sent once a week to each unique sender. The people who 
have sent you messages are kept in the files .vacation.pag and .vacation.dir in your 
home directory. The -I option initializes these files, and should be executed before 
you modify your .forward file. 

If the -I flag is not specified, vacation reads the first line from the standard input for a 
UNIX-style "From" line to determine the sender. If this is not present, a nasty diag- 
nostic is produced. sendmail(8) includes the "From" line automatically. 

No message is sent if the initial "From" line includes the string "-REQUEST®" or if a. 
"Precedence: bulk" or "Precedence: junk" line is included in the header. 

sendmail(8) 



C 



( 



( 
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VAL(1) 



NAME 



SYNOPSIS 



val - validate SCCS file 



val- 



val [-s] [-rSID] [-mname] [-ytype] files 

DESCRIPTION 

val determines if the specified file is an SCCS file meeting the characteristics specified 
by the optional argument list. Arguments to val may appear in any order. The argu- 
ments consist of key letter arguments, which begin with a -, and named files. 

val has a special argument, -, which causes reading of the standard input until an 
end-of-file condition is detected. Each line read is independently processed as if it 
were a command line argument list. 

val generates diagnostic messages on the standard output for each command line and 
file processed, and also returns a single 8-bit code upon exit as described below. 

The keyletter arguments are defined as follows. The effects of any keyletter argu- 
ment apply independently to each named file on the command line. 

-s The presence of this argument silences the diagnostic message normally 

generated on the standard output for any error that is detected while 
processing each named file on a given command line. 

-rSID The argument value SID (SCCS ID entification String) is an SCCS delta 

number. A check is made to determine if the SID is ambiguous (e. g., rl 
is ambiguous because it physically does not exist but implies 1.1, 1.2, 
etc., which may exist) or invalid (e. g., rl.O or rl.1.0 are invalid because 
neither case can exist as a valid delta number). If the SID is valid and 
not ambiguous, a check is made to determine if it actually exists. 

-nname The argument value name is compared with the s-lSCCS %M% key- 
word in file. 

-yiype The argument value type is compared with the SCCS %Y% keyword in 

file. 

The 8-bit code returned by val is a disjunction of the possible errors, i. e., can be interpreted as a bit 
string where (moving from left to right) set bits are interpreted as follows: 

bit = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = cannot open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 = %M%, -m mismatch; 

Note that val can process two or more files on a given command line and in turn can process multi- 
ple command lines (when reading the standard input). In these cases an aggregate code is returned 
- a logical OR of the codes generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l). 



DIAGNOSTICS 



Use helptt) for explanations. 
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BUGS ( ) 

vol can process up to 50 files on a single command line. Any number above 50 will 
produce a core dump. 



( 



( 
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VC(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



:if condition 



VC(1) 



vc - version control 

vc [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 

The vc command copies lines from the standard input to the standard output under 
control of its arguments and control statements encountered in the standard input. In 
the process of performing the copy operation, user declared keywords may be 
replaced by their string value when they appear in plain text and/or control state- 
ments. 

The copying of lines from the standard input to the standard output is conditional, 
based on tests (in control statements) of keyword values specified in control state- 
ments or as vc command arguments. 

A control statement is a single line beginning with a control character, except as 
modified by the -t keyletter (see below). The default control character is colon (:), 
except as modified by the -c keyletter (see below). Input lines beginning with a 
backslash (\) followed by a control character are not control lines and are copied to 
the standard output with the backslash removed. Lines beginning with a backslash 
followed by a non-control character are copied in their entirety. 

A keyword is composed of 9 or less alphanumerics; the first must be alphabetic. A 
value is any ASCII string that can be created with ed(l); a numeric value is an 
unsigned string of digits. Keyword values may not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword surrounded by 
control characters is encountered on a version control statement. The -a keyletter 
(see below) forces replacement of keywords in all lines of text. An uninterpreted 
control character may be included in a value by preceding it with \. If a literal \ is 
c v sired, then it too must be preceded by \. 

Keyletter Arguments 

-a Forces replacement of keywords surrounded by control characters with 

their assigned value in all text lines and not just in vc statements. 

-t All characters from the beginning of a line up to and including the first 

tab character are ignored for the purpose of detecting a control state- 
ment. If one is found, all characters up to and including the tab are dis- 
carded. 

-cchar Specifies a control character to be used in place of :. 

-s Silences warning messages (not error) that are normally printed on the 

diagnostic output. 

Version Control Statements 

:dcl keyword[, ..., keyword] 

Used to declare keywords. All keywords must be declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement overrides the assignment 
for the corresponding keyword on the vc command line and all previous asg's 
for that keyword. Keywords declared, but not assigned values have null 
values. 



rend 
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Used to skip lines of the standard input. If the condition is true all lines I 

between the if statement and the matching end statement are copied to the stan- ^ 

dard output. If the condition is false, all intervening lines are discarded, includ- 
ing control statements. Note that intervening if statements and matching end 
statements are recognized solely for the purpose of maintaining the proper if- 
end matching. 
The syntax of a condition is: 



<cond> 

<or> 

<and> 

<exp> 

<op> 

<value> 



:= [ "not" ] <or> 

:= <and> | <and> T <or> 

:= <exp> | <exp> "&" <and> 

:= "(" <or> ")" | <value> <op> <value> 

:= "=" | "!=" | »<" | »>» 

:= <arbitrary ASCII string> | <numeric string> 



The available operators and their meanings are: 



'= 



equal 
not equal 



& and 

| or 

> greater than 

< less than 

( ) used for logical groupings 

not may only occur immediately after the if, and 

when present, inverts the value of the d^ 

entire condition I 

The > and < operate only on unsigned integer values (e.g., : 012 > 12 is false). 
All other operators take strings as arguments (e.g., : 012 != 12 is true). The pre- 
cedence of the operators (from highest to lowest) is: 

= != >< all of equal precedence 

& 

I 
Parentheses may be used to alter the order of precedence. 
Values must be separated from operators or parentheses by at least one blank 
or tab. 

::text 

Used for keyword replacement on lines that are copied to the standard output. 
The two leading control characters are removed, and keywords surrounded by 
control characters in text are replaced by their value before the line is copied to 
the output file. This action is independent of the -a keyletter. 

:on 

toff- 
Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message | 

Prints the given message followed by: V 

ERROR: err statement on line ... (915) 
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on the diagnostic output, vc halts execution, and returns an exit code of 1. 

SEE ALSO 

ed(l),help(l). 

DIAGNOSTICS 

Use help(l) for explanations. 

EXIT CODES 

- normal 

1 - any error 
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VERS(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



VERS(1) 



vers - obtain version information 

vers [-iV] object-files 

The vers command prints out the version number of the compiler or assembler used 
to create the .0 files, or the loader used to create a.out files. 

If the object file is an archive, the file is treated as a set of individual object files. 

The -i option prints the contents of the ident section. The -V option prints out the 
version number of the vers command. 



( 



SEE ALSO 



cpp(l), a.out(4) 



( 



( 
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VGRIND(1) 

NAME 
SYNOPSIS 

DESCRIPTION 



FILES 



VGRIND(1) 



vgrind - grind nice listings of programs 

vgrind [ -f ] [ - ] [ -t ] [ -n ] [ -x ] [ -W ] [ -sn ] [ -h header ] [ -d file ] [ ^language ] 
name ... 

Vgrind formats the program sources which are arguments in a nice style using troff (1) 
Comments are placed in italics, keywords in bold face, and the name of the current 
function is listed down the margin of each page as it is encountered. 

Vgrind runs in two basic modes, filter mode or regular mode. In filter mode vgrind 
acts as a filter in a manner similar to tbl(l). The standard input is passed directly to 
the standard output except for lines bracketed by the troff-like macros: 

.vS - starts processing 

.vE - ends processing 

These lines are formatted as described above. The output from this filter can be 
passed to troff for output. There need be no particular ordering with eqn(l) or tbl(l). 

In regular mode vgrind accepts input files, processes them, and passes them to troff (I) 
for output. 

In both modes vgrind passes any lines beginning with a decimal point without 
conversion. 

The options are: 

-f forces filter mode 

forces input to be taken from standard input (default if -f is specified ) 

-t similar to the same option in troff causing formatted text to go to the standard 
output 

-n forces no keyword bolding 

-x outputs the index file in a "pretty" format. The index file itself is produced 
whenever vgrind is run with a file called index in the current directory. The 
index of function definitions can then be run off by giving vgrind the -x option 
and the file index as argument. 

-W forces output to the (wide) Versatec printer rather than the (narrow) Varian 

-s specifies a point size to use on output (exactly the same as the argument of a 
.ps) 

-h specifies a particular header to put on every output page (default is the file 
name) 

-d specifies an alternate language definitions file (default is /usr/lib/vgrindefs) 

-1 specifies the language to use. Currently known are PASCAL (-lp), MODEL 
(-lm),C (-1c or the default), CSH (-lcsh), SHELL (-Ish), RATFOR (-lr), 
MODULA2 (-lmod2), YACC (-lyacc), ISP (-lisp), and ICON (-11). 



index 

/usr/lib/tmac/tmac.vgrind 
/usr/lib/vfontedpr 
/usr/lib/vgrindefs 



file where source for index is created 
macro package 
preprocessor 
language descriptions 
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VGRIND(1) 

AUTHOR 
SEE ALSO 
BUGS 



VGRIND (1) 



Dave Presotto & William Joy 
vlp(l), vtroff(l), vgrindefs(5) 

Vfontedpr assumes that a certain programming style is followed: 

For C - function names can be preceded on a line only by spaces, tabs, or an asterisk. 
The parenthesized arguments must also be on the same line. 

For PASCAL - function names need to appear on the same line as the keywords 
function or procedure. 

For MODEL - function names need to appear on the same line as the keywords is 
beginproc. 

If these conventions are not followed, the indexing and marginal function name com- 
ment mechanisms will fail. 

More generally, arbitrary formatting styles for programs mostly look bad. The use of 
spaces to align source code fails miserably; if you plan to vgrind your program you 
should use tabs. This is somewhat inevitable since the font used by vgrind is variable 
width. 

The mechanism of ctags in recognizing functions should be used here. 

Filter mode does not work in documents using the -me or -ms macros. (So what use 
is it anyway?) 



o 



( 



( 
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VI(1) 

NAME 
SYNOPSIS 

DESCRIPTION 



INVOCATION 



VI MODES 



Vl(1) 



vi - screen-oriented (visual) display editor based on ex 

vi [ -t tag ] [ -tfile ] [ -wn ] [ -R ] [ -x ] [+command ] name ... 
view [ -t tag. ] [ -r file ] [ -wn ] [ -R ] [ -x ] [ ^command ] name 
vedit [ -t tag ] [ -r file ] [ -wn ] [ -R ] [ -x ] [ ^command ] name 

vi (visual) is a display-oriented text editor based on an underlying line editor ex(l). 
It is possible to use the command mode of ex from within vi and vice-versa. 

When using vi, changes you make to the file are reflected in what you see on your 
terminal screen. The position of the cursor on the screen indicates the position 
within the file. 

The following invocation options are interpreted by vi: 

-ttag Edit the file containing the tag and position the editor at its 

definition. 

-tfile Recover file after an editor or system crash. If file is not specified a 

list of all saved files will be printed. 

-wn Set the default window size to n. This is useful when using the edi- 

tor over a slow speed line. 

-R Read only mode; the readonly flag is set, preventing accidental 

overwriting of the file. 

■^command The specified ex command is interpreted before editing begins. 

-x Encryption option; when this option is used, the file will be 

encrypted as it is being written and will require an encryption key 
to be read (see crypt(D). Also, see the WARNING section at the end 
of this manual page. 

The name argument indicates files to be edited. 

The view invocation is the same as vi except that the readonly flag is set. 

The vedit invocation is intended for beginners. The report flag is set to 1, and the 
showmode and novice flags are set. These defaults make it easier to get started 
learning the editor. 

Command Normal and initial mode. Other modes return to command mode 

upon completion. ESC (escape) is used to cancel a partial command. 

Input Entered by the following options aiAIoOcCsSR. Arbitrary 

text may then be entered. Input mode is normally terminated with 
ESC character, or abnormally with interrupt. 

Last line Reading input for : / ? or !; terminate with CR to execute, interrupt 

to cancel. 
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VI (1) 

COMMAND SUMMARY 




Sample commands 




+-4T-* 


arrow keys move the cursor 


hjkl 


same as arrow keys 


itextESC 


insert text abc 


cwnewBSC 


change word to new 


easESC 


pluralize word 


X 


delete a character 


dw 


delete a word 


dd 


delete a line 


3dd 


... 3 lines 


u 


undo previous change 


ZZ 


exit vi, saving changes 


:q!CR 


quit, discarding changes 


/textCR 


search for text 


A U A D 


scroll up or down 


:ex cmdCR 


any ex or ed command 



Vl(1) 



C 



Counts before vi commands 

Numbers may be typed as a prefix to some commands. They are interpreted in one 
of these ways. 

line/column number z G I 
scroll amount A D A U 

repeat effect most of the rest 



Interrupting, canceling 




ESC 


end insert or incomplete cmd 


DEL 


(delete or rubout) interrupts 


A L 


reprint screen if DEL scrambles it 


A R 


reprint screen if A L is -> key 


File manipulation 




:wCR 


write back changes 


:qCR 


quit 


:q!CR 


quit, discard changes 


:e nameCR 


edit file name 


:e!CR 


reedit, discard changes 


:e + nameCR 


edit, starting at end 


:e +nCR 


edit starting at line n 


:e#CR 


edit alternate file 




synonym for :e # 


:w nameCR 


write file name 


:w! nameCR 


overwrite file name 


:shCR 


run shell, then return 


-.IcmdCR 


run cmd, then return 


:nCR 


edit next file in arglist 


:n argsCR 


specify new arglist 


A G 


show current file and line 


:ta tagCR 


to tag file entry tag 


A ] 


:ta, following word is tag In general, any ex or ed command 




(such as substitute or global) may be typed, preceded by a colon 




and followed by a CR. 



( 



Positioning within file 



c 
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A F 

A B 
A D 
A U 
G 

/pat 

Ipat 

n 

N 

/pat/+n 

?pat?-n 

] 

[ 



% 

Adjusting the screen 

A L 

A R 

zCR 

z-CR 

z.CR 

/pat/z-CR 

zn.CR 

A E 

a y 

Marking and returning 



forward screen 

backward screen 

scroll down half screen 

scroll up half screen 

go to specified line (end default) 

next line matching pat 

prev line matching pat 

repeat last / or ? 

reverse last / or ? 

nth line after pat 

nth line before pat 

next section/function 

previous section/ function 

beginning of sentence 

end of sentence 

beginning of paragraph 

end of paragraph 

find matching ( ) { or } 

clear and redraw 

retype, eliminate @ lines 

redraw, current at window top 

... at bottom 

... at center 

pat line at bottom 

use n line window 

scroll window down 1 line 

scroll window up 1 line 

move cursor to previous context 
... at first non-white in line 



mx 


mark current position with lette 


*x 


move cursor to mark x 


'x 


... at first non- white in line 


Line positioning 




H 


top line on screen 


L 


last line on screen 


M 


middle line on screen 


+ 


next line, at first non-white 


- 


previous line, at first non-white 


CR 


return, same as + 


ior j 


next line, same column 


Tor k 


previous line, same column 


Character positioning 




A 


first non white 





beginning of line 


$ 


end of line 


hor — > 


forward 


lor<- 


backwards 


A H 


same as <- 
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space 

fx 

Fx 

tx 

Tx 



% 

Words, sentences, paragraphs 

w 

b 

e 

) 

} 

( 

{ 

W 

B 

E 

Corrections during insert 

A R 
A W 

erase 

kill 

\ 

ESC 

DEL 
a d 

T A D 
A D 
a V 



insert and replace 



a 

i 

A 

I 

o 

O 

XX 

RtextmC 



same as -> 

find x forward 

f backward 

upto x forward 

back upto x 

repeat last f F t or T 

inverse of ; 

to specified column 

find matching ( { ) or } 

word forward 
back word 
end of word 
to next sentence 
to next paragraph 
back sentence 
back paragraph 
blank delimited word 
backW 
to end of W 

erase last character 

erase last word 

your erase, same as A H 

your kill, erase input this line 

quotes A H, your erase and kill 

ends insertion, back to command 

interrupt, terminates insert 

backtab over autoindent 

kill autoindent, save for next 

... but at margin next also 

quote non-printing character 

append after cursor 
insert before cursor 
append at end of line 
insert before first non-blank 
open line below 
open above 

replace single char with x 
replace characters 



c 



c 



Operators 



Operators are followed by a cursor motion, and affect all text that would have been 

moved over. For example, since w moves over a word, dw deletes the word that 

would be moved over. Double the operator, e.g., dd to affect whole lines. 

d delete 

c change 

y yank lines to buffer 

< left shift 

> right shift 



c 
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Ed 



ftjua 



Utilities 



Vl(1) 



filter through command 
indent for LISP 



Miscellaneous C 


operations 






C 


change rest of line (c$) 




D 


delete rest of line (d$) 




s 


substitute chars (cl) 




S 


substitute lines (cc) 




J 


join lines 




X 


delete characters (dl) 




X 


... before cursor (dh) 




Y 


yank lines (yy) 


Yank and Put 







Put inserts the text most recently deleted or yanked. However, if a buffer is named, 

the text in that buffer is put instead. 

p put back text after cursor 

P put before cursor 

"xp put from buffer x 

"xy yank to buffer x 

"xd delete into buffer x 



Undo, Redo, Retrieve 

u 
U 



AUTHOR 



FILES 



SEE ALSO 



WARNING 



BUGS 



repeat last change 

"dp 



undo last change 
restore current line 

retrieve d'th last delete 



vi and ex were developed by The University of California, Berkeley California, Com- 
puter Science Division, Department of Electrical Engineering and Computer Science. 



/usr/lib/terminfo/?/* 



compiled terminal description database 
/usr/lib/.COREterm/?/* subset of compiled terminal 
description database, 
supplied on hard disk 



ed(l),edit(l),ex(l). 
User's Guide. 
Editing Guide. 

The -x option is provided with the Security Administration Utilities, which is avail- 
able only in the United States. 

Tampering with entries in /usr/lib/.COREterm/?/* or /usr/lib/terminfo/?/* (for example, 
changing or removing an entry) can affect programs such as vi(l) that expect the 
entry to be present and correct. In particular, removing the "dumb" terminal may 
cause unexpected problems. 

Software tabs using A T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals do not make use of insert and delete 
character operations in the terminal. 
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W(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

AUTHOR 

BUGS 



W(1) 



w - who is on and what they are doing 

w [ -h ] [ -s ] [ user ] 

w prints a summary of the current activity on the system, including what each user is 
doing. The heading line shows the current time of day, how long the system has 
been up, the number of users logged into the system, and the load averages. The 
load average numbers give the number of jobs in the run queue averaged over 1, 5 
and 15 minutes. 

The fields output are: the users login name, the name of the tty the user is on, the 
time of day the user logged on, the number of minutes since the user last typed any- 
thing, the CPU time used by all processes and their children on that terminal, the 
CPU time used by the currently active processes, the name and arguments of the 
current process. 

The -h flag suppresses the heading. The -s flag asks for a short form of output. In 
the short form, the tty is abbreviated, the login time and cpu times are left off, as are 
the arguments to commands. -1 gives the long output, which is the default. 

If a user name is included, the output will be restricted to that user. 

/etc/utmp 
/dev/kmem 

who(l), finger(l), ps(l) 

Mark Horton 

The notion of the "current process" is muddy. The current algorithm is "the highest 
numbered process on the terminal that is not ignoring interrupts, or, if there is none, 
the highest numbered process on the terminal". This fails, for example, in critical 
sections of programs like the shell and editor, or when faulty programs running in 
the background fork and fail to ignore interrupts. (In cases where no process can be 
found, w prints "-".) 

The CPU time is only an estimate, in particular, if someone leaves a background pro- 
cess running after logging out, the person currently on that terminal is "charged" 
with the time. 

Background processes are not shown, even though they account for much of the load 
on the system. 

Sometimes processes, typically those in the background, are printed with null or gar- 
baged arguments. In these cases, the name of the command is printed in 
parentheses. 

w does not know about the new conventions for detection of background jobs. It will 
sometimes find a background job instead of the right one. 



( 



( 
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WAIT(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



WAIT(1) 



SEE ALSO 
CAVEAT 



BUGS 



wait - await completion of process 
wait [ n ] 

Wait for your background process whose process id is n and report its termination 
status. If n is omitted, all your shell's currently active background processes are 
waited for and the return code will be zero. 

The shell itself executes wait, without creating a new process. 
sh(l). 

If you get the error message cannot fork, too many -processes, try using the wait{\) com- 
mand to clean up your background processes. If this doesn't help, the system pro- 
cess table is probably full or you have too many active foreground processes. (There 
is a limit to the number of process ids associated with your login, and to the number 
the system can keep track of.) 

Not all the processes of a 3- or more-stage pipeline are children of the shell, and thus 
cannot be waited for. 

If n is not an active process id, all your shell's currently active background processes 
are waited for and the return code will be zero. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



WALL(1) 



wall - write to all users 



/etc/wall 



( 



wall reads its standard input until an end-of-file. It then sends this message to all 
currently logged-in users preceded by: 

Broadcast Message from . . . 

It is used to warn all users, typically prior to shutting down the system. 

The sender must be super-user to override any protections the users may have 
invoked (see mesgd)). 

/dev/tty* 

mesg(l), write(l). 

"Cannot send to ..." when the open on a user's tty file fails. 



( 



( 



500 



Stardent 1500/3000 



Essential Utilities 



WC(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



WC(1) 



wc - word count 

wc [ -lwc ] [ names ] 

wc counts lines, words, and characters in the named files, or in the standard input if 
no names appear. It also keeps a total count for all named files. A word is a maximal 
string of characters delimited by spaces, tabs, or new-lines. 

The options 1, w, and c may be used in any combination to specify that a subset of 
lines, words, and characters are to be reported. The default is -lwc. 

When names are specified on the command line, they will be printed along with the 
counts. 
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WHAT(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 

DIAGNOSTICS 

BUGS 



WHAT(1) 



what - identify SCCS files 

what [-s] files 

what searches the given files for all occurrences of the pattern that get (1) substitutes 
for %Z% (this is @(#) at this printing) and prints out what follows until the first ~, >, 
new-line, \, or null character. For example, if the C program in file f.c contains 

char ident[] = " @(#)identification information "; 
and f.c is compiled to yield f .o and a.out, then the command 

what f.c f.o a.out 

will print 

f.c: 

identification information 



f.o: 



a.out: 



identification information 



identification information 



what is intended to be used in conjunction with the command get (I), which automat- 
ically inserts identifying information, but it can also be used where the information is 
inserted manually. Only one option exists: 

-s Quit after finding the first occurrence of pattern in each file. 

get(l),help(l). 

Exit status is if any matches are found, otherwise 1. Use help (I) for explanations. 

It is possible that an unintended occurrence of the pattern @(#) could be found just 
by chance, but this causes no harm in nearly all cases. 



( 



( 



( 
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WHATIS(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



WHATIS(1) 



whatis - describe what a command is 



whatis command ... 



whatis looks up a given command and gives the header line from the manual section. 
You can then run the man(l) command to get more information. If the line starts 
'name(section) ../ you can do 'man section name' to get the documentation for it. Try 
'whatis ed' and then you should do 'man 1 ed' to get the manual. 

whatis is actually just the -f option to the man(l) command. 



FILES 
SEE ALSO 



/usr/man/whatis 



man(l), catman(8) 



Data base 
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WHEREIS(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



OPTIONS 



EXAMPLE 



WHEREIS(1) 



whereis - locate the binary, source, and manual page files for a command 

whereis [ -bmsu ] [ -BMS directory. . . -f ] filename . . . 

whereis locates source/binary and manuals sections for specified files. The supplied 
names are first stripped of leading pathname components and any (single) trailing 
extension of the form xxt, for example, .c. Prefixes of s. resulting from use of source 
code control are also dealt with, whereis then attempts to locate the desired pro- 
gram in a list of standard places: 

/usr/bin 

/usr/bin 

/usr/5bin 

/usr/hosts 

/usr/include 

/usr/local 

/usr/etc 

/usr/lib 

/usr/share/man 

/usr/src 

/usr/ucb 

-b Search only for binaries. 

-m Search only for manual sections. 

-s Search only for sources. 

-u Search for unusual entries. A file is said to be unusual if it does not have one 
entry of each requested type. Thus 'whereis -m -u *' asks for those files in 
the current directory which have no documentation. 

-B Change or otherwise limit the places where whereis searches for binaries. 

-M Change or otherwise limit the places where whereis searches for manual sec- 
tions. 

-S Change or otherwise limit the places where whereis searches for sources. 

-f Terminate the last directory list and signals the start of file names, and must be 
used when any of the -B, -M, or -S options are used. 

Find all files in /usr/bin which are not documented in /usr/share/man/manl with 
source in /usr/src/cmd: 



C 



c 



FILES 



SEE ALSO 



example % cd /usr/ucb 

example % whereis -u -M /usr/share/man/manl -S /usr/src/cmd -f * 

/usr/src/* 

/usr/{doc,man}/* 

/etc^usr/flib^in^cb^ld^ew^ocal} 

chdir(2) 



( 
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BUGS 

Since whereis uses chdir(2) to run faster, pathnames given with the -M, -S, or -B 
must be full; that is, they must begin with a V. 
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WH1CH(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
DIAGNOSTICS 

BUGS 



WHICH (1) 

which - locate a program file including aliases and paths 

which [ name ] ... 

which takes a list of names and looks for the files which would be executed had these 
names been given as commands. Each argument is expanded if it is aliased, and 
searched for along the user's path. Both aliases and path are taken from the user's 
.cshrc file. 



V.cshrc 



source of aliases and path values 



A diagnostic is given for names which are aliased to more than a single word, or if an 
executable file with the argument name was not found in the path. 

Must be executed by a csh, since only csh's know about aliases. 



c 



( 



c 
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WH0(1) 

NAME 
SYNOPSIS 



DESCRIPTION 



WH0(1) 



who - who is on the system 

who [-uTIHqpdbrtas] [ file ] 
who am i 
who am I 

who can list the user's name, terminal line, login time, elapsed time since activity 
occurred on the line, and the process-ID of the command interpreter (shell) for each 
current UNIX system user. It examines the /etc/utmp file at login time to obtain its 
information. If file is given, that file (which must be in utmp[£] format) is examined. 
Usually, file will be /etc/wtmp, which contains a history of all the logins since the file 
was last created. 

who with the am i or am I option identifies the invoking user. 

The general format for output is: 

name [state] line time [idle] [pid] [comment] [exit] 

The name, line, and time information is produced by all options except -q; the state 
information is produced only by -T; the idle and pid information is produced only by 
-u and -1; and the comment and exit information is produced only by -a. The infor- 
mation produced for -p, -d, and -r is explained during the discussion of each option, 
below. 

With options, who can list logins, logoffs, reboots, and changes to the system clock, as 
well as other processes spawned by the init process. These options are: 

-u This option lists only those users who are currently logged in. The name is the 
user's login name. The line is the name of the line as found in the directory 
/dev. The time is the time that the user logged in. The idle column contains the 
number of hours and minutes since activity last occurred on that particular 
line. A dot (.) indicates that the terminal has seen activity in the last minute 
and is therefore "current". If more than twenty-four hours have elapsed or 
the line has not been used since boot time, the entry is marked old. This field 
is useful when trying to determine whether a person is working at the termi- 
nal or not. The pid is the process-ID of the user's shell. The comment is the 
comment field associated with this line as found in /etc/inittab (see inittab[4]). 
This can contain information about where the terminal is located, the tele- 
phone number of the dataset, type of terminal if hard-wired, etc. 

-T This option is the same as the -s option, except that the state of the terminal 
line is printed. The state describes whether someone else can write to that ter- 
minal. A + appears if the terminal is writable by anyone; a - appears if it is 
not. root can write to all lines having a + or a - in the state field. If a bad line 
is encountered, a ? is printed. 

-1 This option lists only those lines on which the system is waiting for someone 
to login. The name field is LOGIN in such cases. Other fields are the same as 
for user entries except that the state field does not exist. 

-H This option will print column headings above the regular output. 

-q This is a quick who, displaying only the names and the number of users 
currently logged on. When this option is used, all other options are ignored. 
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WH0(1) WH0(1) 

~p This option lists any other process which is currently active and has been pre- 
viously spawned by init. The name field is the name of the program executed 
by init as found in /etc/inittab. The state, line, and idle fields have no meaning. 
The comment field shows the id field of the line from /etc/inittab that spawned 
this process. Seeinittab(A). 

-d This option displays all processes that have expired and not been respawned 
by init. The exit field appears for dead processes and contains the termination 
and exit values (as returned by wait[2]), of the dead process. This can be use- 
ful in determining why a process terminated. 

-b This option indicates the time and date of the last reboot. 

-r This option indicates the current run-level of the init process. In addition, it 
produces the process termination status, process id, and process exit status 
(see utmp(4)) under the idle, fid, and comment headings, respectively. 

-t This option indicates the last change to the system clock (via the date[l] com- 
mand) by root. Seesw(l). 

-a This option processes /etc/utmp or the named file with all options turned on. 

-s This option is the default and lists only the name, line, and time fields. 

Note to the super-user: after a shutdown to the single-user state, who returns a 
prompt; the reason is that since /etc/utmp is updated at login time and there is no 
login in single-user state, who cannot report accurately on this state, who am i, how- 
ever, returns the correct information. 

FILES 

/etc/utmp 
/etc/wtmp 
/etc/inittab 

SEE ALSO 

date(l), init(lM), login(l), mesg(l), su(lM), wait(2), inittab(4), utmp(4). 



C 



( 



( 
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WHOAMI(1) 



WH0AM1(1) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 



whoami - print effective current user id 



whoami 



Whoami prints who you are. It works even if you are su'd, while 'who am i' does not 
since it uses /etc/utmp. 

/etc/passwd Name data base 

who (1) 
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SYNOPSIS 
DESCRIPTION 



WHODO (1M) WHODO(1M) 

NAME 

whodo - who is doing what 

/etc/whodo 

whodo produces formatted and dated output from information in the /etc/utmp and 
/etc/ps_data files. 

The display is headed by the date, time and machine name. For each user logged in, 
device name, user-id and login time is shown, followed by a list of active processes 
associated with the user-id. The list includes the device name, process-id, cpu 
minutes and seconds used, and process name. 

The command: 

whodo 

produces a display like this: 

Tue Mar 12 15:48:03 1985 
bailey 



( 



EXAMPLE 



tty09 men 8:51 
tty09 28158 0:29 sh 

tty52 bdr 15:23 
tty52 21688 0:05 sh r 

tty52 22788 0:01 whodo I 

tty52 22017 0:03 vi V 

tty52 22549 0:01 sh 

xtl62 lee 10:20 
tty08 6748 0:01 layers 
xtl62 6751 0:01 sh 
xtl63 6761 0:05 sh 
tty08 6536 0:05 sh 



FILES 



/etc/passwd 
/etc/ps_data 
/etc/utmp 

SEE ALSO 

ps(l),who(l). 



( 
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WRITE(1) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



write - write to another user 
write user [ line ] 

write copies lines from your terminal to that of another user. When first called, it 
sends the message: 

Message from yourname (tty??) [ date ]. . . 

to the person you want to talk to. When it has successfully completed the connec- 
tion, it also sends two bells to your own terminal to indicate that what you are typing 
is being sent. 

The recipient of the message should write back at this point. Communication contin- 
ues until an end of file is read from the terminal, an interrupt is sent, or the recipient 
has executed "mesg n". At that point write writes EOT on the other terminal and 
exits. 

If you want to write to a user who is logged in more than once, the line argument 
may be used to indicate which line or terminal to send to (e.g., ttyOO); otherwise, the 
first writable instance of the user found in /etc/utmp is assumed and the following 
message posted: 

user is logged on more than one place. 
You are connected to "terminal". 
Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesgd) command. Writ- 
ing to others is normally allowed by default. Certain commands, such as pr(l) disal- 
low messages in order to prevent interference with their output. However, if the 
user has super-user permissions, messages can be forced onto a write-inhibited ter- 
minal. 

If the character ! is found at the beginning of a line, write calls the shell to execute the 
rest of the line as a command. 

The following protocol is suggested for using write: when you first write to another 
user, wait for them to write back before starting to send. Each person should end a 
message with a distinctive signal (i.e., (o) for "over") so that the other person knows 
when to reply. The signal (oo) (for "over and out") is suggested when conversation 
is to be terminated. 



/etc/utmp 
/bin/sh 



to find user 
to execute ! 



mail(l), mesgd), pr(D, sh(l), who(l). 

"user is not logged on" if the person you are trying to write to is not logged on. 

"Permission denied" if the person you are trying to write to denies that permission 
(with mesg). 

"Warning: cannot respond, set mesg -y" if your terminal is set to mesg n and the reci- 
pient cannot respond to you. 

"Can no longer write to user" if the recipient has denied permission {mesg n) after you 
had started writing. 
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XARQS(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



XARGS(1) 



xargs - construct argument list(s) and execute command 

xargs [flags] [ command [initial-arguments] ] 

xargs combines the fixed initial-arguments with arguments read from standard input 
to execute the specified command one or more times. The number of arguments read 
for each command invocation and the manner in which they are combined are deter- 
mined by the flags specified. 

command, which may be a shell file, is searched for, using one's $PATH. If command is 
omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous strings of char- 
acters delimited by one or more blanks, tabs, or new-lines; empty lines are always 
discarded. Blanks and tabs may be embedded as part of an argument if escaped or 
quoted. Characters enclosed in quotes (single or double) are taken literally, and the 
delimiting quotes are removed. Outside of quoted strings a backslash (\) will escape 
the next character. 

Each argument list is constructed starting with the initial-arguments, followed by 
some number of arguments read from standard input (Exception: see -i flag). Flags 
-i, -1, and -n determine how arguments are selected for each command invocation. 
When none of these flags are coded, the initial-arguments are followed by arguments 
read continuously from standard input until an internal buffer is full, and then com- 
mand is executed with the accumulated args. This process is repeated until there are 
no more args. When there are flag conflicts (e.g., -1 vs. -n), the last flag has pre- 
cedence. Flag values are: 

Anumber command is executed for each non-empty number lines of arguments 
from standard input. The last invocation of command will be with fewer 
lines of arguments if fewer than number remain. A line is considered to 
end with the first new-line unless the last character of the line is a blank 
or a tab; a trailing blank/tab signals continuation through the next 
non-empty line. If number is omitted, 1 is assumed. Option -x is 
forced. 

-ireplstr Insert mode: command is executed for each line from standard input, 
taking the entire line as a single arg, inserting it in initial-arguments for 
each occurrence of replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of replstr. Blanks 
and tabs at the be^innin 0- of each line are thrown awa xjr * Constructed 
arguments may not grow larger than 255 characters, and option -x is 
also forced. {} is assumed for replstr if not specified. 

-xmumber Execute command using as many standard input arguments as possible, 
up to number arguments maximum. Fewer arguments will be used if 
their total size is greater than size characters, and for the last invocation 
if there are fewer than number arguments remaining. If option -x is 
also coded, each number arguments must fit in the size limitation, else 
xargs terminates execution. 

-t Trace mode: The command and each constructed argument list are 

echoed to file descriptor 2 just prior to their execution. 

-p Prompt mode: The user is asked whether to execute command each 

invocation. Trace mode (-t) is turned on to print the command instance 
to be executed, followed by a ?. . . prompt. A reply of y (optionally 



( 



( 
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XARGS(1) 



XARGS(1) 



-x 



-ssize 



EXAMPLES 



SEE ALSO 



followed by anything) will execute the command; anything else, includ- 
ing just a carriage return, skips that particular invocation of command. 

Causes xargs to terminate if any argument list would be greater than 
size characters; -x is forced by the options -i and -1. When neither of 
the options -i, -1, or -n are coded, the total length of all arguments 
must be within the size limit. 

The maximum total size of each argument list is set to size characters; 
size must be a positive integer less than or equal to 470. If -s is not 
coded, 470 is taken as the default. Note that the character count for size 
includes one extra character for each argument and the count of charac- 
ters in the command name. 



-eeofstr 



eofstr is taken as the logical end-of-file string. Underbar (_) is assumed 
for the logical EOF string if -e is not coded. The value -e with no eofstr 
coded turns off the logical EOF string capability (underbar is taken 
literally), xargs reads standard input until either end-of-file or the logi- 
cal EOF string is encountered. 

xargs will terminate if either it receives a return code of -1 from, or if it cannot exe- 
cute, command. When command is a shell program, it should explicitly exit (see sh(D) 
with an appropriate value to avoid accidentally returning with -1. 

The following will move all files from directory $1 to directory $2, and echo each 
move command just before doing it: 

Is $1 I xargs -i -t mv $1/0 $2/{} 

The following will combine the output of the parenthesized commands onto one line, 
which is then echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs »log 

The user is asked which files in the current directory are to be archived and archives 
them into arch (1.) one at a time, or (2.) many at a time. 

1. Is I xargs -p -1 ar r arch 

2. Is I xargs -p -1 I xargs ar r arch 

The following will execute diff{\) with successive pairs of arguments originally typed 
as shell arguments: 

echo $* I xargs -n2 diff 



sh(l). 
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XSTR(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
BUGS 



XSTR(1) 



xstr - extract strings from C programs to implement shared strings 

xstr [ -c ] [ - ] [ file ] 

xstr maintains a file strings into which strings in component parts of a large program 
are hashed. These strings are replaced with references to this common area. This 
serves to implement shared constant strings, most useful if they are also read-only. 

The command 

xstr -c name 

will extract the strings from the C source in name, replacing string references by 
expressions of the form (&xstr [number]) for some number. An appropriate declara- 
tion of xstr is prepended to the file. The resulting C text is placed in the file x.c, to 
then be compiled. The strings from this file are placed in the strings data base if they 
are not there already. Repeated strings and strings which are suffices of existing 
strings do not cause changes to the data base. 

After all components of a large program have been compiled a file xs.c declaring the 
common xstr space can be created by a command of the form 

xstr 

This xs.c file should then be compiled and loaded with the rest of the program. If 
possible, the array can be made read-only (shared) saving space and swap overhead. 

xstr can also be used on a single file. A command 

xstr name 

creates files x.c and xs.c as before, without using or affecting any strings file in the 
same directory. 

It may be useful to run xstr after the C preprocessor if any macro definitions yield 
strings or if there is conditional code which contains strings which may not, in fact, 
be needed, xstr reads from its standard input when the argument '-' is given. An 
appropriate command sequence for running xstr after the C preprocessor is: 

cc-Ename.c I xstr-c- 

cc -c x.c 

mv x.o name.o 

xstr does not touch the file strings unless new items are added, thus make can avoid 
remakine xs.o unless trulv necessarv. 



strings 
x.c 
xs.c 
/tmp/xs* 

mkstr(l) 



Data base of strings 

Massaged C source 

C source for definition of array 'xstr' 

Temp file when 'xstr name' doesn't touch strings 



If a string is a suffix of another string in the data base, but the shorter string is seen 
first by xstr both strings will be placed in the data base, when just placing the longer 
one there will do. 



c 



i 



( 
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YACC(1) 

NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



DIAGNOSTICS 



CAVEAT 



YACC(1) 



yacc - yet another compiler-compiler 

yacc [ -vdlt ] grammar 

The yacc command converts a context-free grammar into a set of tables for a simple 
automaton which executes an LR(1) parsing algorithm. The grammar may be ambi- 
guous; specified precedence rules are used to break ambiguities. 

The output file, y.tab.c, must be compiled by the C compiler to produce a program 
yyparse. This program must be loaded with the lexical analyzer program, yylex, as 
well as main and yyerror, an error handling routine. These routines must be supplied 
by the user; lex(l) is useful for creating lexical analyzers usable by yacc. 

If the -v flag is given, the file y.output is prepared, which contains a description of 
the parsing tables and a report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y.tab.h is generated with the #define statements that 
associate the y^cc-assigned "token codes" with the user-declared "token names". 
This allows source files other than y.tab.c to access the token codes. 

If the -1 flag is given, the code produced in y.tab.c will not contain any #line con- 
structs. This should only be used after the grammar and the associated actions are 
fully debugged. 

Runtime debugging code is always generated in y.tab.c under conditional compila- 
tion control. By default, this code is not included when y.tab.c is compiled. How- 
ever, when yacc's -t option is used, this debugging code will be compiled by default. 
Independent of whether the -t option was used, the runtime debugging code is 
under the control of YYDEBUG, a preprocessor symbol. If YYDEBUG has a non-zero 
value, then the debugging code is included. If its value is zero, then the code will not 
be included. The size and execution time of a program produced without the run- 
time debugging code will be smaller and slightly faster. 



defines for token names 

temporary files 

parser prototype for C programs 



y.output 

y.tab.c 

y.tab.h 

yacc.tmp, 

yacc.debug, yacc.acts 

/usr / lib /yaccpar 

lex(l). 
Programmer's Guide. 



The number of reduce-reduce and shift-reduce conflicts is reported on the standard 
error output; a more detailed report is found in the y.output file. Similarly, if some 
rules are not reachable from the start symbol, this is also reported. 

Because file names are fixed, at most one yacc process can be active in a given direc- 
tory at a given time. 
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NAME 

yes - be repetitively affirmative 

SYNOPSIS 

yes [ expletive ] 

DESCRIPTION 

yes repeatedly outputs "yes", or if expletive is given, that is output repeatedly. Termi- 
nation is by rubout. 



C 
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NAME 

intro - introduction to system maintenance procedures 

DESCRIPTION 

This section outlines certain procedures that will be of interest to those charged with 
the task of system maintenance. Included are discussions of such topics as boot pro- 
cedures, recovery from crashes, file backups, etc. 

SEE ALSO 

Installation/ Administration Guide. 
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NAME (^ 

accton - system accounting 

SYNOPSIS 

/etc/accton [ file ] 

DESCRIPTION 

With an argument naming an existing file, accton causes system accounting informa- 
tion for every process executed to be placed at the end of the file. If no argument is 
given, accounting is turned off. 

SEE ALSO 

acct(2) 



( 



C 
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ARP(8C) 

NAME 
SYNOPSIS 



DESCRIPTION 



ARP(8C) 



arp - address resolution display and control 

arp hostname 

arp -a [ unix ] [ kmem ] 

arp -d hostname 

arp -s hostname ether jiddr [ temp ] [ pub ] [ trail ] 

arp -f filename 

The arp program displays and modifies the Internet-to-Ethernet address translation 
tables used by the address resolution protocol (arp(4p)). 

With no flags, the program displays the current ARP entry for hostname. The host 
may be specified by name or by number, using Internet dot notation. With the -a 
flag, the program displays all of the current ARP entries by reading the table from 
the file kmem (default /dev/kmem) based on the kernel file unix (default /unix). 

With the -d flag, a super-user may delete an entry for the host called hostname. 

The -s flag is given to create an ARP entry for the host called hostname with the Ether- 
net address ether jiddr. The Ethernet address is given as six hex bytes separated by 
colons. The entry will be permanent unless the word temp is given in the command. 
If the word pub is given, the entry will be "published"; i.e., this system will act as an 
ARP server, responding to requests for hostname even though the host address is not 
its own. The word trail indicates that trailer encapsulations may be sent to this host. 

The -f flag causes the file filename to be read and multiple entries to be set in the ARP 
tables. Entries in the file should be of the form 



SEE ALSO 



hostname ether 'jiddr [ temp ] [ pub ] [ trail ] 
with argument meanings as given above. 

inet(3N), arp(4) 
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NAME 
SYNOPSIS 



BOOT(8) 



DESCRIPTION 



boot - system boot procedure 

Autoboot: 

Ensure the bottom key switch is in the horizontal position. 
Turn the top key switch one position to the right. 

Manual Boot: 

prom X> b [<boot device>][<boot file>] [-s I I -m] [rootdev=<root device>] 
[swapdev=<swap device>] 

eg: 

prom X> b 

prom X> b unix 

prom X> b /usr/ken/unix 

prom X> b scsi(l,5,l)unix rootdev=scsi(l,5,l) 

The front panel key switches and the PROM monitor environment variables control 
the boot sequence. 

The front panel key switches are located under the decorative, corrugated facade on 
the front of the machine. This panel can be slid up and down to expose or conceal the 
tape drive and key switches. 

The upper key switch has three positions: off (vertical), on (the first position to the 
right), and reset (the second, spring-loaded position to the right). The lower key 
switch defines the action to be taken when the upper key is turned into the spring- 
loaded position. The lower key switch has two positions: standard (the horizontal 
position) and maintenance (the vertical position). For normal operations, keep the 
lower switch in the standard, horizontal position. This will enable autobooting to the 
run level specified in /etc/inittab. Place the lower key switch in the maintenance, 
vertical position to manually boot the machine, boot UNIX in single-user mode, or to 
interrupt UNIX. 

The Prom Monitor retains environment variables in non-volatile memory which are 
used to define the default actions taken by the boot process. These variables specify: 
the boot device (disk, tape, or ethernet), the boot file (UNIX or a stand alone pro- 
gram), the default root and swap disk partitions, and the name and location of the 
secondary boot program. The variable settings given below specify to autoboot 
UNIX from the SCSI controller 1, unit (disk) 5, partition 0. 

bootmode = a 

bootfile = unix 

path = scsi(l,5,0) 

rootdev = scsi(l,5,0) 

swapdev = scsi(l,5,l) 

secondary = scsi(l,5,8)sash 

To disable autoboot, unset the bootmode environment variable. Use the Prom Moni- 
tor n command to display, set, and unset Prom Monitor Environment Variables. 

When booting UNIX manually, additional arguments may be specified which will 
override the settings of the environment Variables. 
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Argument Meaning 

-s Boot unix to single-user run level 

-m Boot unix to the run level specified in /etc/inittab 

-rootdev= specify the root device and partition, e.g., scsi(l,5,l) 

-swapdev= specify the swap device and partition, e.g., scsi(0,5,l) 

FILES 

scsi(l,5,0)unix - standard UNIX kernel 
scsi(l,5,8)sash ~ secondary boot program 

SEE ALSO 

intro(7), shutdown(lM), dvhtool(lM) 

Installation/ Administration Guide appendix, Prom Manual 

BUGS 

It is sometimes necessary to issue a Prom reset command after a boot failure to boot 
successfully. 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



CATMAN (8) 



catman - create the cat files for the manual 

/etc/catman [ ~p ] [ -n ] [ -w ] [ -Mpath ] [ sections ] 

catman creates the preformatted versions of the on-line manual from the nroff input 
files. Each manual page is examined and those whose preformatted versions are 
missing or out of date are recreated. If any changes are made, catman will recreate 
the whatis database. 

If there is one parameter not starting with a '-', it is taken to be a list of manual sec- 
tions to look in. For example 

catman 123 

will cause the updating to only happen to manual sections 1, 2, and 3. 
Options: 



( 



-n 

-P 
-w 

-M 



prevents creations of the whatis database. 

prints what would be done instead of doing it. 

causes only the whatis database to be created. No manual reformatting is 
done. 



updates manual pages located in the set of directories specified by path 
(/usr/man by default). Path has the form of a colon (':') separated list of direc- 
tory names, for example 7usr/local/man:/usr/man'. If the environment vari- 
able 'MANPATH' is set, its value is used for the default path. 

If the nroff source file contains only a line of the form '.so manx/yyy.x', a symbolic 
link is made in the catx directory to the appropriate preformatted manual page. 



( 



/usr/man 

/usr/man/man?/*.* 

/usr/man/cat?/*.* 

/usr/man/bsd 

/usr/man/whatis 



default manual directory location 

raw (nroff input) manual sections 

preformatted manual pages 

manual directory location for bsd man pages 

whatis database 



/usr/lib/makewhatis command script to make whatis database 



man(l) 



( 



Stardent 1500/3000 



User Commands 



COMSAT (8C) 

NAME 

SYNOPSIS 

DESCRIPTION 



COMSAT (8C) 



FILES 
SEE ALSO 
BUGS 



comsat - biff server 



/etc/comsat 



Comsat is the server process which receives reports of incoming mail and notifies 
users if they have requested this service. Comsat receives messages on a datagram 
port associated with the "biff" service specification (see sewices{5) and inetd(8)). The 
one line messages are of the form 

user@mailbox-offset 

If the user specified is logged in to the system and the associated terminal has the 
owner execute bit turned on (by a "biff y"), the offset is used as a seek offset into the 
appropriate mailbox file and the first 7 lines or 560 characters of the message are 
printed on the user's terminal. Lines which appear to be part of the message header 
other than the "From", "To", "Date", or "Subject" lines are not included in the 
displayed message. 

/etc/utmp to find out who's logged on and on what terminals 

biff(l),inetd(8) 

The message header filtering is prone to error. The density of the information 
presented is near the theoretical minimum. 

Users should be notified of mail which arrives on other machines than the one to 
which they are currently logged in. 

The notification should appear in a separate window so it does not mess up the 
screen. 
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DUMP(8) 

NAME 
SYNOPSIS 



DESCRIPTION 



WARNINGS 



FILES 



SEE ALSO 



DUMP (8) 



dump - capture the state of the memory for later analysis using crash(lM) 

Use the Prom Monitor to copy memory to the default dump device: 
prom X> sysdump 

Reboot the system 

Use dd to copy unix and system dump to cartridge tape: 

dd if=/unix of=/dev/rmtx bs=512k 

dd if=/dev/dsk/cld5sl of=/dev/rmtXX bs=512k count=64 

Use the procedure given above to create a system dump. 

If UNIX is hung, attempt to interrupt UNIX by placing the lower key switch in the 
maintenance (vertical) position and then turning the upper key switch to the spring- 
loaded position to the right. If this fails, reset the machine and request access to the 
Prom Monitor. This is accomplished by: 

Turning the lower key to the standard (horizontal) position. Turning the upper key 
to the spring loaded-position to the right. Then, within three seconds, turning the 
lower key to the maintenance (vertical) position. If the Prom Environment variable 
bootmode is not set and thereby disabling autoboot, only the first two steps are neces- 
sary. Note: the above procedure may require two hands. 

Once the Prom Monitor has control, follow the procedure outlined in the synopsis. 
Note than when coping UNIX to the tape one should use a non-rewind on close, high 
density tape device. Then when coping the contents of the dump device to tape, one 
should specify a count which describes the size of main memory. 

The Prom Environment Variable dumpdev describes the default device which will be 
used by the Prom Monitor to hold the system dump. The variable dumpdev is nor- 
mally set to the swap partition. 

The tape is by convention written in high density format and blocked in 512K byte 
blocks. If convention has not been followed, please indicate the procedure used on 
the tape label. 

/dev/xxx — high density no rewind on close cartridge tape device 
/dev/xxx - high density cartridge tape device 

boot(7M), Titian Prom Manual 
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FTPD(8C) 

NAME 

SYNOPSIS 

DESCRIPTION 



FTPD(8C) 



ftpd - DARPA Internet File Transfer Protocol server 

/etc/f tpd [ -d ] [ -1 ] [ -ttimeout ] 

ftpd is the DARPA Internet File Transfer Prototocol server process. The server uses 
the TCP protocol and listens at the port specified in the "ftp" service specification; 
see services (5). 

If the -d option is specified, debugging information is written to the syslog. 

If the -1 option is specified, each ftp session is logged in the syslog. 

The ftp server will timeout an inactive session after 15 minutes. If the -t option is 
specified, the inactivity timeout period will be set to timeout. 

The ftp server currently supports the following ftp requests; case is not dis- 
tinguished. 

Request Description 

ABOR abort previous command 

ACCT specify account (ignored) 

ALLO allocate storage (vacuously) 

APPE append to a file 

CDUP change to parent of current working directory 

CWD change working directory 

DELE delete a file 

HELP give help information 

LIST give list files in a directory ("Is -lg") 

MKD make a directory 

MODE specify data transfer mode 

NLST give name list of files in directory ("Is") 

NOOP do nothing 

PASS specify password 

PASV prepare for server-to-server transfer 

PORT specify data connection port 

PWD print the current working directory 

QUIT terminate session 

RETR retrieve a file 

RMD remove a directory 

RNFR specify rename-from file name 

RNTO specify rename-to file name 

STOR store a file 

STOU store a file with a unique name 

STRU specify data transfer structure 

TYPE specify data transfer type 

USER specify user name 

XCUP change to parent of current working directory 

XCWD change working directory 

XMKD make a directory 

XPWD print the current working directory 

XRMD remove a directory 

The remaining ftp requests specified in Internet RFC 959 are recognized, but not 
implemented. 
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FTPD(BC) 



SEE ALSO 
BUGS 



FTPD(8C) 

The ftp server will abort an active file transfer only when the ABOR command is pre- 
ceded by a Telnet "Interrupt Process" (IP) signal and a Telnet "Synch" signal in the 
command Telnet stream, as described in Internet RFC 959. 

Ftpd interprets file names according to the "globbing" conventions used by csh(l). 
This allows users to utilize the metacharacters "*?[] {}-"• 

Ftpd authenticates users according to three rules. 

1) The user name must be in the password data base, /etc/passzvd, and not have a 
null password. In this case a password must be provided by the client before 
any file operations may be performed. 

2) The user name must not appear in the file /etc/ftpusers . 

3) The user must have a standard shell returned by getusershell(3). 

4) If the user name is "anonymous" or "ftp", an anonymous ftp account must be 
present in the password file (user "ftp"). In this case the user is allowed to log 
in by specifying any password (by convention this is given as the client host's 
name). 

In the last case, ftpd takes special measures to restrict the client's access privileges. 
The server performs a chroot(2) command to the home directory of the "ftp" user. In 
order that system security is not breached, it is recommended that the "ftp" subtree 
be constructed with care; the following rules are recommended. 

-ftp) 

Make the home directory owned by "ftp" and unwritable by anyone. 

-ftp/bin) 

Make this directory owned by the super-user and unwritable by anyone. The 
program Zs(l) must be present to support the list commands. This program 
should have mode 111. 

-ftp/etc) 

Make this directory owned by the super-user and unwritable by anyone. The 
files passwd(5) and group (5) must be present for the Is command to work prop- 
erly. These files should be mode 444. 

-ftp/pub) 

Make this directory mode 777 and owned by "ftp". Users should then place 
files which are to be accessible via the anonymous account in this directory. 

~ftp/dev) 

Make this directory owned by the super-user and unwritable by anyone. Then 
rnknod (1 ) for tcp in this directory: 

mknod ~ftp/dev/tcp c 14 
chmod 666 ~ftp/dev/tcp 

ftp(lC), getusershell(3), syslogd(8) 

The anonymous account is inherently dangerous and should avoided when possible. 

The server must run as the super-user to create sockets with privileged port 
numbers. It maintains an effective user id of the logged in user, reverting to the 
super-user only when binding addresses to sockets. The possible security holes have 
been extensively scrutinized, but are possibly incomplete. 
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NAME 



SYNOPSIS 
DESCRIPTION 



gated - gateway routing daemon 
gated[-t[i][e][r][p][u][R][H]][logfile] 



gated is a routing daemon that handles multiple routing protocols and replaces 
routed (8), egpup(8), and any routing daemon that speaks the HELLO routing protocol. 
gated currently handles the RIP, EGP, and HELLO routing protocols. The gated process 
can be configured to perform all routing protocols or any combination of the three. 
The configuration for gated is by default stored in the file /etc/ gated. conf and can be 
changed at compile time in the file defs.h . 

COMMAND LINE TRACING OPTIONS 

gated can be invoked with a number of tracing flags and/or a log file. Tracing flags 
may also be specified in the configuration file with the traceflags clause, gated forks 
and detaches itself from the controlling terminal unless tracing flags are specified 
without specifying a log file, in which case all tracing output is sent to the controlling 
terminal. The valid tracing flags are as follows: 

-t If used alone, log all error messages, route changes and EGP packets sent 

and received. Using this flag alone turns on the i, e, r, and p trace flags 
automatically. When used with another flag, the -t has no effect and only 
the accompanying flags are recognized. Note that when using other flags, 
the -t flag must be used with them. 

i Log all internal errors and interior routing errors. 

e Log all external errors due to EGP, exterior routing errors, and EGP state 

changes. 

r Log all routing changes. 

p Trace all EGP packets sent and received. 

u Log all routing updates sent. 

R Trace all RIP packets received. 

H Trace all HELLO packets received. 

The gated process always logs fatal errors. If no log file is specified and no tracing 
flags are set, all messages are sent to /dev/null. 

SIGNAL PROCESSING 

gated catches a number of signals and performs specific actions. Currently gated does 
special processing with the SIGHUP and SIGINT signals. 

When a SIGHUP is sent to the gated process and gated is invoked with trace flags and a 
log file, tracing is toggled off and the log file is closed. At this point the log file may 
be moved or removed. The next SIGHUP to gated will toggle the tracing on. gated 
reads the configuration file and sets the tracing flags to those specified with the 
traceflags clause. If no traceflags clause is specified tracing is resumed using the trace 
flags specified on the command line. The log file specified in the command line is 
created if necessary and the trace output is sent to that file. The trace output is 
appended to an already existing log file. This is useful for having rotating log files 
like those of the syslog daemon. 

Sending gated a SIGINT will cause a memory dump to be scheduled within the next 
sixty seconds. The memory dump will be written to the file /usr/tmp/gated_dump . 
gated will finish processing pending routing updates before performing the memory 
dump. The memory dump contains a snapshot of the current gated status, including 
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the interface configurations, EGP neighbor status and the routing tables. If the file I 

/usr/tmp/gated_dump already exists, the memory dump will be appended to the exist- ^ 

ing file. 

CONFIGURATION FILE OPTIONS FOR CONTROLLING TRACING OUTPUT 

traceflags traceflag [ traceflag ] [ traceflag ] ... 

The clause tells the gated process what level of tracing output is desired. This option 
is read during gated initialization and whenever gated receives a SIGHUP . This option 
is overriden at initialization time if tracing flags are specified on the command line. 
The valid tracing flags are as follows; 

internal Log all internal errors and interior routing errors. 

external Log all external errors due to EGP, exterior routing errors, and EGP state 
changes. 

route Log all routing changes. 

egp Trace all EGP packets sent and received. 

update Log all routing updates sent. 

rip Trace all RIP packets received. 

hello Trace all HELLO packets received. 

general A combination of internal, external, route, and egp. 

all Enable all of the above tracing flags. 

If more than one traceflags clause is used, the tracing flags accumulate. 

CONFIGURA TION FILE OPTIONS FOR HANDLING ROUTING PROTOCOLS ^ 

In this section, the numerous configuration options are explained. Each time the I 

gated process is started, it reads the file I etcj gated. conf to obtain its instructions on how ^ 

routing will be managed with respect to each protocol. The configuration options are 
as follows: 

RIP {yes I no I supplier I pointopoint I quiet I gateway #} 

This tells the gated process how to perform the RIP routing protocol. Only one of the 
above RIP arguments is allowed after the keyword RIP. If more than one is specified, 
only the first one is recognized. A list of the arguments to the RIP clause follows: 

yes Perform the RIP protocol. Process all incoming RIP packets and supply RIP 

information every thirty seconds only if there are two or more network 
interfaces. 

no Do not perform the RIP protocol. Do not perform RIP. 

supplier 

Perform the RIP protocol. Process all incoming RIP packets and force the 
supplying of RIP information every thirty seconds no matter how many net- 
work interfaces are present. 

pointopoint 

Perform the RIP protocol. Process all incoming RIP packets and force the 
supplying of RIP information every thirty seconds no matter how many net- 
work interfaces are present. When this argument is specified, RIP informa- 
tion will not be sent out in a broadcast packet. The RIP information will be 
sent directly to the gateways listed in the sourceripgateways option described 
below. 
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quiet Process all incoming RIP packets, but do not supply any RIP information no 
matter how many network interfaces are present. 

gateway # 

Process all incoming RIP packets, supply RIP information every thirty 
seconds, and announce the default route (0.0.0.0) with a metric of #. The 
metric should be specified in a value that represents a RIP hopcount. With 
this option set, all other default routes coming from other RIP gateways will 
be ignored. The default route is only announced when actively peering 
with at least one EGP neighbor and therefore should only be used when EGP 
is used. 

If no RIP clause is specified, RIP will not be performed. 

HELLO {yes I no I supplier I pointopoint I quiet I gateway #} 

This tells the gated process how to perform the HELLO routing protocol. The argu- 
ments parallel the RIP arguments, but do have some minor differences. Only one of 
the above HELLO arguments is allowed after the keyword HELLO. If more than one is 
specified, only the first one is recognized. A list of the arguments to the HELLO 
clause follows: 

yes Perform the HELLO protocol. Process all incoming HELLO packets and sup- 

ply HELLO information every fifteen seconds only if there are two or more 
network interfaces. 

no Do not perform the HELLO protocol. Do not perform HELLO. 

supplier 

Perform the HELLO protocol. Process all incoming HELLO packets and force 
the supplying of HELLO information every fifteen seconds no matter how 
many network interfaces are present. 

pointopoint 

Perform the HELLO protocol. Process all incoming HELLO packets and force 
the supplying of HELLO information every fifteen seconds no matter how 
many network interfaces are present. When this argument is specified, 
HELLO information will not be sent out in a broadcast packet. The HELLO 
information will be sent directly to the gateways listed in the sourcehellogate- 
ways option described below. 

quiet Process all incoming HELLO packets, but do not supply any HELLO informa- 
tion despite the number of network interfaces present. 

gateway # 

Process all incoming HELLO packets, supply HELLO information every 
fifteen seconds, and announce the default route (0.0.0.0) with a time delay of 
#. The time delay should be specified in milliseconds. The default route is 
only announced when actively peering with at least one of EGP neighbor, 
therefore should only be used when running EGP. 

If no HELLO clause is specified, HELLO will not be performed. 

EGP {yes I no} 

This clause allows the processing of EGP by gated to be turned on or off. 

no Do not perform any EGP processing. 

yes Perform all EGP operations. 

Please note that by default, EGP processing will take place. Therefore, if no EGP 
clause is specified, all EGP operations will take place. 
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autonomoussystem # f 

If performing the EGP protocol, this clause must be used to specify the autonomous 
system number (#). If not specified, gated will exit and give a fatal error message. 

egpmaxacquire # 

If performing the EGP protocol, this clause specifies the number of EGP peers with 
whom gated will be performing EGP. This number must be greater than zero and less 
than or equal to the number of EGP neighbors specified or gated will exit. 

egpneighbor gateway 

If performing the EGP protocol, this clause specifies with whom gated will be per- 
forming EGP. gateway can be either a symbolic name in /etc/hosts or an IP hostname in 
Internet dot (a.b.c.d) notation. Dot notation is recommended to avoid confusion. 
Each EGP neighbor will be acquired in the order listed in the configuration file. 

CONFIGURATION FILE OPTIONS FOR HANDLING ROUTING INFORMATION 

The following configuration file options tell gated how to deal with both incoming 
and outgoing routing information. 

trustedripgateways gateway [gateway] [gateway] 

trustedhellogateways gateway [gateway] [gateway] 

When these clauses are specified, gated will only listen to RIP or HELLO information, 
respectively from these RIP or HELLO gateways, gateway can be either a symbolic 
name from /etc/hosts or an IP host address in dot notation (a.b.c.d). Again, dot nota- 
tion is recommended to eliminate confusion. Please note that the propagation of 
routing information is not restricted by this clause. 

sourceripg ate ways gateway [gateway] [gateway] 

sourcehellogateways gateway [gateway] [gateway] 

gated will send RIP or HELLO information directly to the gateways specified. If pointo- 
point is specified in the RIP or HELLO clauses mentioned above, gated will only send 
RIP or HELLO information to the specified gateways, gated will NOT send out any 
information using the broadcast address. If pointopoint is not specified in those 
clauses and gated is supplying RIP or HELLO information, gated will send information 
to the specified gateways as well as broadcasting it using a broadcast address. 

noripoutinterface intfaddr [intfaddr] [intfaddr] 

nohellooutinterf ace intfaddr [intfaddr] [intfaddr] 

noripfrominterface intfaddr [intfaddr] [intfaddr] ..... 

nohellofrominterf ace intfaddr [intfaddr] [intfaddr] 

The above clauses turn protocols on and off on a per interface basis. 
no{rip I hellojfrominterface means that no RIP or HELLO information will be accepted 
coming into the listed interfaces from another gateway. no{rip\hello}outinterface 
means that no RIP or HELLO knowledge will be sent out of the listed interfaces. 
intfaddr should be in dot notation (a.b.c.d). 

passiveinterfaces intfaddr [intfaddr] [intfaddr] 

In order to dynamically determine if an interface is properly functioning, gated will 
time out an interface when no RIP, HELLO, or EGP packets are being received on that 
particular interface. PSN interfaces send a RIP or HELLO packet to themselves to 
determine if the interface is properly functioning as the delay between EGP packets 
may be longer than the interface timeout. Interfaces that have timed out automati- 
cally have their routes re-installed when routing information is again received over 
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the interface. The above clause stops gated from timing out the listed interfaces. The 
interfaces listed will always be considered up and working. If gated is not a RIP or 
HELLO supplier, all interfaces will not be aged and the passiveinterfaces automatically 
applies to all interfaces. 

interf acemetric intf addr metric# 

This feature allows the specification of an interface metric for the listed interface. On 
systems that support interface metrics, this clause will override the kernel's metric. 
On systems that do not have support for an interface metric, this feature allows the 
specificification of one. The interface metric is added to the true metric of each route 
that comes in via routing information from the listed interface. The interface metric 
is also added to the true metric of any information sent out via the listed interface. 
This clause is required for each interface on which an interface metric is desired. 

reconstmetric intf addr metric# 

This is a first attempt to throw hooks for fallback routing into gated. If the above 
clause is used, the metrics of the routes contained in any RIP information coming into 
the listed interface will be set to the specified metrictt . Metric reconstitution should 
not be used lightly, since it could be a major contributor in the formation of routing 
loops. USE THIS WITH EXTREME CAUTION. Any route that has a metric of infinity 
will not be reconstituted and left as infinity. 

fixedmetric intf addr proto {rip I hello} metric# 

This is another attempt to throw hooks for fallback routing into gated. If the above 
clause is used, all routing information sent out the specified interface will have a 
metric of metric# . For RIP, specify the metric as a RIP hopcount from to infinity. 
For HELLO, specify the metric as a HELLO delay in milliseconds from to infinity. 
Any route that has a metric of infinity will be left as infinity. Fixed metrics should 
also be USED WITH EXTREME CAUTION! 

donotlisten net intf addr [addr] ... proto {rip I hello} 

donotlistenhost host intf addr [addr] ... proto {rip I hello} 

This clause reads as follows: keyword donotlisten followed by a network number, 
which should be in dot notation followed by keyword intf. Then a list of interfaces in 
dot notation precede the keyword proto, followed by rip or hello. 

This means that any information regarding net coining in via the specified protocols 
AND from the specified interfaces will be ignored. The keyword all may be used 
after the keyword intf to specify all interfaces on the machine. For example: 

donotlisten 10.0.0.0 intf 128.84.253.200 proto rip 

means that any RIP information about net 10.0.0.0 coming in via interface 
128.84.253.200 will be ignored. One clause is required for each net on which this res- 
triction is desired. 

donotlisten 26.0.0.0 intf all proto rip hello 

means that any RIP and HELLO information about net 26.0.0.0 coming in via any 
interface will be ignored. 

donotlistenhost can be described the same way as above except that a host address is 
provided instead of a network address. Restrictions of the nature described above 
are applied to the specified host route learned of by the specified routing protocol. 

listen net gateway addr [addr] ... proto {rip I hello} 
listenhost host gateway addr [addr] ... proto {rip I hello} 
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This clause reads as follows: keyword listen followed by a network number which 
should be in dot notation followed by keyword gateway. Then a list of gateways in 
dot notation should precede the keyword proto, followed by rip or hello. 

This means to only listen to information about network net by the specified 
protocol(s) only from the listed gateways. For example: 

listen 128.84.0.0 gateway 128.84.253.3 proto hello 

means that any HELLO information about net 128.84 coming in via gateway 
128.84.253.3 will be accepted. Any other information about 128.84 from any other 
gateway will be rejected. One clause is necessary for each net to be restricted. 

listenhost 26.0.0.15 gateway 128.84.253.3 proto rip 

means that any information about host 26.0.0.15 must come via RIP and from gate- 
way 128.84.253.3. All other information regarding this host will be ignored. 

announce net intf addr [addr] ... proto type [egpmetric #] 

announcehost host intf addr ... proto type [egpmetric #] 

noannounce net intf addr [addr] ... proto type [egpmetric #] 

noannouncehost host intf addr ... proto type [egpmetric #] 

These clauses allow restriction of the networks and hosts announced and by which 
protocol. The announce(host) and noannounce(host) clauses may not be used together 
on the same interface. With the announce{host) clause, gated will only announce the 
nets or hosts that have an associated announce{host) clause with the appropriate pro- 
tocol. With the noannounce(host) clause, gated will announce everything, EXCEPT 
those nets or hosts that have an associated noannounce{host) clause. This allows a 
choice of announcing only what is on the announce list or everything except those 
nets on the noannounce list on a per interface basis. 

The arguments are the same as in the donotlisten clause except egp may be specified in 
the proto field, type can either be rip, hello, egp, or any combination of the three. 
When egp is specified in the proto field, an egp metric must be specified. This is the 
metric at which gated will announce the listed net via EGP . 

Please note that these are not static route entries. These restrictions will only apply if 
the net or host is learned via one of the routing protocols. If a restricted network 
suddenly becomes unreachable and goes away, announcement of this net will stop 
until it is learned again. 

Currently, only one announce(host) or noannounce(host) may be specified per network 
or host* It is not possible to announce a network or host via HELLO out one interface 
and via RIP out another. 

Some examples: 

announce 128.84 intf all proto rip hello egp egpmetric 

announce 10.0.0.0 intf all proto rip 

announce 0.0.0.0 intf 128.84.253.200 proto rip 

announce 35.0.0.0 intf all proto rip egp egpmetric 3 

With only these four announce clauses in the configuration file, this gated process will 
only announce these four nets. It will announce 128.84.0.0 via RIP and HELLO to all 
interfaces and announce it via EGP with a metric of 0. Net 10.0.0.0 will be announced 
via RIP to all interfaces. Net 0.0.0.0 (default) will be announced by RIP out interface 
128.84.253.200 only. Net 35.0.0.0 will be announced via RIP to all interfaces and 
announced via EGP with a metric of 3. These are the only nets that will be broadcast 
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by this gateway. Once the first announce clause is specified, only the nets with 
announce clauses will be broadcast; this includes local subnets. Once an 
announce(host) or noannounce(host) has an all specified after an intf, that clause is 
applied globally and the option of having per interface restrictions is lost. If no rout- 
ing announcement restrictions are desired, announce clauses should not be used. All 
information learned will then be propagated out. Please note that this has no affect 
on the information to which gated listens. Any net that does not have an announce 
clause is still added to the kernel routing tables, but it is not announced via any of the 
routing protocols. To stop nets from being added to the kernel the donotlisten clause 
may be used. 

announce 128.84 intf 128.59.2.1 proto rip 
noannounce 128.84 intf 128.59.1.1 proto rip 

The above clauses mean that on interface 128.59.2.1, only information about 
128.84.0.0 will be announced via RIP, but on interface 128.59.1.1, all information will 
be announced, except 128.84.0.0 via RIP. 

noannounce 128.84 intf all proto rip hello egp egpmetric 
noannounce 10.0.0.0 intf all proto hello 

These clauses mean that except for the two specified nets, all nets will be propogated. 
Specifically, net 128.84.0.0 will not be announced on any interface via any protocols. 
Knowledge of 128.84.0.0 is not sent anywhere. Net 10.0.0.0 will not be announced via 
HELLO to any interface. This also implies that net 10.0.0.0 will be announced to every 
interface via RIP. This net will also be broadcast via EGP with a metric specified in the 
defaultegpmetric clause. 

defaultegpmetric # 

This is a default EGP metric to use when there are no routing restrictions. Normally, 
with no routing restrictions, gated announces all networks learned via HELLO or RIP 
via EGP with this specified default EGP metric. If this clause is not used, the default 
EGP metric is set to 255, which would make any EGP advertised route of this nature 
be ignored. When there are no routing restrictions, any network with a direct inter- 
face is announced via EGP with a metric of 0. Note that this does not include subnets, 
but only the non-subnetted network. 

def aultgateway gateway proto {active I passive} 

This initial default gateway is installed in the kernel routing tables during startup 
and initialization. If EGP is being used, as soon as an update is received from an EGP 
neighbor, this default route is deleted. If EGP is not being used, but RIP or HELLO are, 
and active is specified, this default route will be deleted and overwritten by default 
learned from any other RIP or HELLO gateway. If no default route is learned via RIP 
or HELLO, this default route will be maintained in the kernel routine tables. If passive 
is specified, the default route will be added to the kernel and will NOT be overwrit- 
ten by any other default route broadcast. The default route will NOT be propogated 
when the passive option is used. 

gateway should be an address in dot notation, proto should be either rip, egp, or hello. 
The proto field initializes the protocol by which the route was learned. Although in 
this case it is unused, but the field is remains for consistency. 

net netaddr gateway addr metric hopcnt {rip I egp I hello} 
host hostaddr gateway addr metric hopcnt {rip I egp I hello} 
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The following clauses install a static route to net netaddr or host hostaddr through I 

gateway addr at a metric of hopcnt learned via either RIP, HELLO, or EGP. As usual, 
dot notation is recommended for the addresses. This route will be installed in the 
kernel's routing table and will never be affected by any other gateway's RIP or 
HELLO announcements. The protocol by which it was learned is important if the 
route is to be announced via EGP. If the protocol is rip or hello and there are no rout- 
ing restrictions, then this route will be announced by EGP with a metric of defaul- 
tegpmetric. If the protocol is egp and there are no routing restrictions, then this route 
will be announced by EGP with "a metric of hopcnt. 

egpnetsreachable net [net] [net] 

This option was left in as a soft restriction. It cannot be used when the announce or 
noannounce clauses are used. Normally, with no restrictions, gated announces all 
routes learned from RIP and HELLO via EGP. The egpnetsreachable clause restricts EGP 
announcement to those nets listed in the clause. TTie metric used for the HELLO and 
RIP learned routes is the value given in the defaultegpmetric clause. If this clause does 
not specify a value, the value is set to 255. With the egpnetsreachable clause, indivi- 
dual unique EGP metrics may not be set for each net. The defaultegpmetric is used for 
all networks except those that are directly connected, which use a metric of 0. 

martiannets net [net] [net] ... 

This clause appends to gated' $ list of martian networks, martian networks are those 
known to be invalid and should be ignored. When gated hears about one of these 
networks through any means, it will immediately ignore it. If external tracing is 
enabled, a message will be printed to the trace log. Multiple occurences of the mar- 
tiannets clause accumulate. 



A initial list of martian networks is coded into gated in the include file rt_controhh. 
This list contains 127.0.0.0, 128.0.0.0, 191.253.0.0, 192.0.0.0, 223.255.255.0, and 
224.0.0.0. 

NOTES ON CONFIG UR A TION OPTIONS 

gated stores its Process ID in the file I etc) gated. pid. 

If EGP is being used when supplying the default route (via RIP gateway or HELLO 
gateway and all EGP neighbors are lost, the default route will not be advertised until 
at least one EGP neighbor is regained. 

If routing restrictions are used, gated logs all invalid networks using syslog at log 
level LOG_WARNING and facility LOG_DAEMON. The facility may be changed at 
compile time by use of the LOG_FACILITY define. 

With the complexitv of the current network to^olo* 5 ^ and with man v back door 
paths to networks, the use of routing restrictions is recommended. With the current 
routing strategies, it is easy for illegal or invalid networks to penetrate into the 
ARPAnet Core or the NSFnet backbone. Using routing restrictions does take a little 
more maintenance time and routing restrictions are not the long term answer, but for 
now, in order to be good internet players, we must use them. 

GA TED INTERNAL METRICS 

gated stores all metrics internally as a HELLO time delay ranging from to 30000. 
Received RIP metrics are translated to and from these internal time delays with the 
use of the following translation tables: 



( 



( 



18 Stardent 1500/3000 



GATED (8) GATED (8) 

Time Delay RIP metric 



0- 










1- 


100 


1 




101- 


148 


2 




149- 
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220- 
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4 
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5 
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713 


6 




714- 
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1567 


8 
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2322 
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3440 


10 
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11 
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Time Delay 
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8 
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9 
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10 
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11 






5097 


12 






7552 


13 






11190 


14 






16579 


15 






24564 


16 






30000 



NOTES ON IMPLEMENTATION SPECIFICS 

gated stores all metrics internally in milliseconds. The RIP metric is mapped to a mil- 
lisecond based metric and processed. This will preserve the granularity of the 
HELLO protocol time delay. 

In the gated configuration file, all references to POINT-TO-POINT interfaces must use 
the DESTINATION address. This is the only change made to the configuration file 
syntax from earlier versions, which used the source address of the PTP link. Other- 
wise, old configuration files should be compatible. 

All protocols have a two minute hold down. When a routing update indicates that 
the route in use is being deleted, gated will not delete the route for two minutes. 

Changes can be made to the interfaces and gated will notice them without having to 
restart the process. If the, netmask, subnetmask, broadcast address, or interface 
metric are changed, the interface should be marked down with ifconfig(8C), then 
marked up at least thirty seconds later. Flag changes do not require the interface to 
be brought down and back up. 
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FILES 



SEE ALSO 



AUTHORS 



CREDITS 



RIP propagates and listens to host routes. This was done to handle FTP links more 
consistently. This version also supports the RIP_TRACE commands. 

Subnet interfaces are supported. Subnet information will only be propogated on 
interfaces to other subnets of the same network. For example, if there is a gateway 
between two class B networks, the subnet routes for each respective class B net are 
not propagated into the other class B net. Just the class B network number is pro- 
pagated. 

gated listens to host and network REDIRECTS and tries to take an action on the 
REDIRECT for its own internal tables that parallels the kernel's action. In this way, 
the redirect routine in gated parallels the Berkeley kernel redirect routine as closely as 
possible. Unlike the Berkeley kernel, gated times out routes learned via a REDIRECT 
after six minutes. The route is then deleted from the kernel routing tables. This 
helps keep the routing tables more consistent. Any route that was learned via a 
REDIRECT is NOT announced by any routing protocol. 

The gated EGP code verifies that all nets sent and received are valid class A, B, or C 
networks per the EGP specification. Information about networks that do not meet 
these criteria is not propogated. If an EGP update packet contains information about 
an network that is not either class A, B or C, the update is considered to be in error 
and is ignored. Only the information about the specific network will be ignored if 
gated is compiled with the EGP_IGNORE_BAD define specified. This option should be 
used with caution. 



/etc/gated.conf 
/etc/ gated. pid 
/iisr/tmpi 'gated _dump 
/etc/gated 



The configuration file. 
The process ID is stored here. 
The memory dump file. 
The GATED process itself. 



routed(8C) 

RFC827 (EGP formal specs.), RFC891 (HELLO formal specs.), RFC911 (EGP under UNIX) 

The con/ directory in the distribution package for sample configuration files. 

Mark Fedor (1986-1987) 
fedor@nisc.nyser.net 

Jeffrey C. Honig 

Cornell Theory Center 

265 Olin Hall 

Cornell University 

Ithaca, NY 14853-5201 

607/255-8686 

jch@tcgould.tn.cornell.edu 

{ucbvax,uunet,decvax}!tcgould.tn.cornell.edu!jch 

This program was derived from Paul Kirton's EGP for UNIX, UC at Berkeley's 
routed(8C), and HELLO routines by Mike Petry at the University of Maryland. 

Special thanks to Craig Partridge, craig@nnsc.nsf.net, for linting, profiling and per- 
formance enhancements. 
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Also, thanks to all the BETA-TESTERS and the NSFNET backbone crew who put up 
with occasional nasty conditions brought on by the development of this program. 
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NAME 

SYNOPSIS 

DESCRIPTION 



SEE ALSO 



■HALT (8) 



halt -stop the processor 

/etc/halt [ -n ] [ -q ] 

halt writes out cached disk information and then enters the PROM monitor. The 
machine does not reboot, even if the auto-reboot switch is set. 

halt without the -n or -q option is equivalent to 

# telinit 

The -q and -n options cause a quick halt, no graceful shutdown is attempted. 
With either the -n or -q option specified, halt is equivalent to 

# /etc/uadmin 2 

init(lM), reboot(8), shutdown(8), telinit(lM), uadmin(lM) 
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SYOPNSIS 

DESCRIPTION 
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ifconfig - configure network interface parameters 

/etc/if config interface [ addressjamily ] [ address [ destjiddress ] ] [ parameters ] 
/etc/if config interface [ protocol_family ] 

Ifconfig is used to assign an address to a network interface and/or configure network 
interface parameters. Ifconfig must be used at boot time to define the network 
address of each interface present on a machine; it may also be used at a later time to 
redefine an interface's address or other operating parameters. The interface parame- 
ter is a string of the form "name unit", e.g. "enO". 

An interface may receive transmissions in differing protocols, each of which may 
require separate naming schemes. If the address family of the specified address is not 
"inet", it is necessary to specify addressjamily, which changes the interpretation of 
the remaining parameters. The "met" address family may be optionally specified, 
since it is the default. Currently, "ns" is the only other option for addressjamily. 

For the DARPA-Internet family, the address is either a host name present in the host 
name data base, hosts{5), or a DARPA Internet address expressed in the Internet stan- 
dard "dot notation". For the Xerox Network Systems(tm) family, addresses are 
neta.b.c.d.e.f, where net is the assigned network number (in decimal), and each of the 
six bytes of the host number, a through /, are specified in hexadecimal. The host 
number may be omitted on lOMb/s Ethernet interfaces, which use the hardware 
physical address, and on interfaces other than the first. 

The following parameters may be set with ifconfig: 

up Mark an interface "up". This may be used to enable an interface 

after an "ifconfig down." It happens automatically when setting the 
first address on an interface. If the interface was reset when previ- 
ously marked down, the hardware will be re-initialized. 

down Mark an interface "down". When an interface is marked "down", 

the system will not attempt to transmit messages through that inter- 
face. If possible, the interface will be reset to disable reception as 
well. This action does not automatically disable routes using the 
interface. 



trailers 



-trailers 
arp 



Request the use of a "trailer" link level encapsulation when sending 
(default). If a network interface supports trailers, the system will, 
when possible, encapsulate outgoing messages in a manner which 
minimizes the number of memory to memory copy operations per- 
formed by the receiver. On networks that support the Address 
Resolution Protocol (see arp(4P); currently, only 10 Mb/s Ethernet), 
this flag indicates that the system should request that other systems 
use trailers when sending to this host. Similarly, trailer encapsula- 
tions will be sent to other hosts that have made such requests. 
Currently used by Internet protocols only. 

Disable the use of a "trailer" link level encapsulation. 

Enable the use of the Address Resolution Protocol in mapping 
between network level addresses and link level addresses (default). 
This is currently implemented for mapping between DARPA Inter- 
net addresses and lOMb/s Ethernet addresses. 
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DIAGNOSTICS 



SEE ALSO 



-arp Disable the use of the Address Resolution Protocol. 

metric n Set the routing metric of the interface to n, default 0. The routing 

metric is used by the routing protocol (routed(8c)). Higher metrics 
have the effect of making a route less favorable; metrics are counted 
as addition hops to the destination network or host. 

debug Enable driver dependent debugging code; usually, this turns on 

extra console error logging. 

-debug Disable driver dependent debugging code. 

netmask mask (Inet only) Specify how much of the address to reserve for subdivid- 
ing networks into sub-networks. The mask includes the network 
part of the local address and the subnet part, which is taken from 
the host field of the address. The mask can be specified as a single 
hexadecimal number with a leading Ox, with a dot-notation Internet 
address, or with a pseudo-network name listed in the network table 
networks (5). The mask contains l's for the bit positions in the 32-bit 
address which are to be used for the network and subnet parts, and 
0's for the host part. The mask should contain at least the standard 
network portion, and the subnet field should be contiguous with the 
network portion. 

dstaddr Specify the address of the correspondent on the other end of a point 

to point link. 

broadcast (Inet only) Specify the address to use to represent broadcasts to the 

network. The default broadcast address is the address with a host 
part of all l's. 

ipdst (NS only) This is used to specify an Internet host who is willing to 

receive ip packets encapsulating NS packets bound for a remote net- 
work. In this case, an apparent point to point link is constructed, 
and the address specified will be taken as the NS address and net- 
work of the destinee. 

Ifconfig displays the current configuration for a netwdrk interface when no optional 
parameters are supplied. If a protocol family is specified, Ifconfig will report only 
the details specific to that protocol family. 

Only the super-user may modify the configuration of a network interface. 

Messages indicating the specified interface does not exit, the requested address is 
unknown, or the user is not privileged and tried to alter an interface's configuration. 

netstat(l), intro(4N) 
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SYNOPSIS 

DESCRIPTION 
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inetd - internet "super-server" 

/etc/inetd [ -d ] [ configuration file ] 

inetd should be run at boot time by /etc/rc2.d/S30tcp. It then listens for connections on 
certain internet sockets. When a connection is found on one of its sockets, it decides 
what service the socket corresponds to, and invokes a program to service the request. 
After the program is finished, it continues to listen on the socket (except in some 
cases which will be described below). Essentially, inetd allows running one daemon 
to invoke several others, reducing load on the system. 

Upon execution, inetd reads its configuration information from a configuration file 
which, by default, is /etc/inetd.conf. There must be an entry for each field of the 
configuration file, with entries for each field separated by a tab or a space. Com- 
ments are denoted by a "#" at the beginning of a line. There must be an entry for 
each field, except as noted below. The fields of the configuration file are as follows: 

service name 

socket type 

protocol 

wait/ no wait 

user 

server program 

server program arguments 

The service name entry is the name of a valid service in the file /etc/services . For "inter- 
nal" services (discussed below), the service name must be the official name of the ser- 
vice (that is, the first entry in /etc/services). For RPC services, the value of the service 
name field consists of the RPC service name, followed by a slash (/) and either a ver- 
sion number or a range of version numbers (for example, mountd/1 ). 

The socket type should be one of "stream", "dgram", "raw", "rdm", or "seqpacket", 
depending on whether the socket is a stream, datagram, raw, reliably delivered mes- 
sage, or sequenced packet socket. 

The protocol must be a valid protocol as given in /etc/protocols. Examples might be 
"tcp" or "udp". For RPC services, the field consists of the string "rpc" followed by a 
slash (/) and the name of the protocol (for example, rpc/udp). 

The wait/nowait entry is applicable to datagram sockets only (other sockets should 
have a "nowait" entry in this space). If a datagram server connects to its peer, free- 
ing the socket so inetd can received further messages on the socket, it is said to be a 
"multi-threaded" server, and should use the "nowait" entry. For datagram servers 
which process all incoming datagrams on a socket and eventually time out, the 
server is said to be "single-threaded" and should use a "wait" entry. "Comsat" 
("biff") and "talk" are both examples of the latter type of datagram server. Tftpd is 
an exception; it is a datagram server that establishes pseudo-connections. It must be 
listed as "wait" in order to avoid a race; the server reads the first packet, creates a 
new socket, and then forks and exits to allow inetd to check for new service requests 
to spawn new servers. 

The user entry should contain the user name of the user as whom the server should 
run. This allows for servers to be given less permission than root. The server program 
entry should contain the pathname of the program which is to be executed by inetd 
when a request is found on its socket. If inetd provides this service internally, this 
entry should be "internal". 
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The arguments to the server program should be just as they normally are, starting I 

with argv[0], which is the name of the program. If the service is provided internally, ^ 

the word "internal" should take the place of this entry. 

Inetd provides several "trivial" services internally by use of routines within itself. 
These services are "echo", "discard", "chargen" (character generator), "daytime" 
(human readable time), and "time" (machine readable time, in the form of the 
number of seconds since midnight, January 1, 1900). All of these services are tcp 
based. For details of these services, consult the appropriate RFC from the Network 
Information Center. 

Inetd rereads its configuration file when it receives a hangup signal, SIGHUP. Ser- 
vices may be added, deleted or modified when the configuration file is reread. 



FILES 

/etc/inetd.conf 
/etc/ services 
/etc/protocols 

SEE ALSO 

ftpd(8C), rlogind(8C), rshd(8C), telnetd(8C), tftpd(8C) 
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NAME 



SYNOPSIS 
DESCRIPTION 



makeindex - index manpages allowing 'man very_long_name' to work 

/usr/lib/makeindex file ... 

makeindex builds a data base of man page file names and man page names. The man 
command uses the data base to find the file name for a particular man page. 

For every file in the argument list, makeindex writes one or more lines on stdout con- 
taining the file name, and a list of manpage names. Man page Index files are created 
by: 

foriinl2345678 

cd /usr/man/man$i 

/usr/lib/makeindex * > ../cat$i/Index 
done 

for i in 1 2 3 

cd /usr/man/bsd/man$i 

/usr/lib/makeindex * > ../cat$i/Index 
done 

FILE FORMAT 

To allow makeindex to locate the name, the source file format of a man-page MUST 
be consistent with the following description. 

The FIRST occurence of a line that begins with .SH must be the line that defines the 
NAME of a function, that is: 

.SHNAME 

The lines that follow the name will all be scanned to locate possible entries for the 
index file. The format of these lines can be any one of the following: 

function \- oneline description 

functionl, function2, functionJSJ \- oneline description 

string: strcat, strcmp, strncmp \- string functions 

The next line that begins with the characters .SH stops the scanning for possible 
index entries, thus allowing multiple lines having the same format to create multiple 
entries. 

An index entry, listing the file name and the function name will be created for each of 
the names listed above. If the manpage named 'samplepage' contained exactly the 
entries shown in the example above, then an 'Index' file would contain the following 
entries: 

samplepage:function 

samplepage:functionl 

samplepage:function2 

samplepage:function_N 

samplepage:strcat 

samplepage:strcmp 

samplepage:string 

samplepage:strncmp 
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In other words, names may be either colon delimited or comma delimited in a one- I 

line description that contains a 'V preceding the actual description of the functions. 
Everything must be in that single-line description to allow indexing to function 
correctly. 

WHAT TO AVOID 

The following layout will not function correctly: 

.SHNAME 

functionl, function2, function3 <newline character > 

V description on this following line. 

.SH SYNOPSIS 

No entries will be created with the above layout. 

.SHNAME 

functionl, function2, functions <newline character > 
function4, function5 \- description of these functions 
.SH SYNOPSIS 

This will result in only function4 and functions being indexed because there is no 
backslash-hyphen used. 

WHAT IS PERMITTED 

The following layout is permitted: 

.SHNAME 

generalname_if_any: fund, func2, func3, func4, func5 V | 

description on this next line V 

.SH SYNOPSIS 

In other words, the elements that cause an entry to be created for a line are the func- 
tion names (comma or colon delimited), and the backslash-hyphen. Any lines not 
containing these elements will be ignored. 



SEE ALSO 



catman(8), man(l) 



( 
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SYNOPSIS 

DESCRIPTION 
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named - Internet domain name server 

named [ -d debuglevel ] [ -p port# ] [{-b} bootfile ] 

named is the Internet domain name server. See RFC883 for more information on the 
Internet name-domain system. Without any arguments, named will read the default 
boot file /etc/named.boot, read any initial data and listen for queries. 

Options are: 

-d Print debugging information. A number after the "d" determines the level of 
messages printed. 

-p Use a different port number. The default is the standard port number as listed 
in /etc/services. 

-b Use an alternate boot file. This is optional and allows you to specify a file with 
a leading dash. 

Any additional argument is taken as the name of the boot file. The boot file contains 
information about where the name server is to get its initial data. If multiple boot 
files are specified, only the last is used. Lines in the boot file cannot be continued on 
subsequent lines. The following is a small example: 



; boot file for name server 

directory / usr /local / domain 



;type 



domain 



source host/file 



backup file 



cache 

primary Berkeley.EDU 

primary 32.128.IN-ADDR.ARPA 

secondary CC.Berkeley.EDU 



root.cache 
berkeley.edu.zone 
ucbhosts.rev 
128.32.137.8 128.32.137.3 cc.zone.bak 



secondary 6.32.128.IN-ADDR.ARPA 128.32.137.8 128.32.137.3 cc.rev.bak 
primary 0.0.127.IN-ADDR.ARPA localhost.rev 

forwarders 10.0.0.78 10.2.0.78 
; slave 

The "directory" line causes the server to change its working directory to the direc- 
tory specified. This can be important for the correct processing of $INCLUDE files in 
primary zone files. 

The "cache" line specifies that data in "root.cache" is to be placed in the backup 
cache. Its main use is to specify data such as locations of root domain servers. This 
cache is not used during normal operation, but is used as "hints" to find the current 
root servers. The file "root.cache" is in the same format as "berkeley.edu.zone". 
There can be more than one "cache" file specified. The cache files are processed in 
such a way as to preserve the time-to-live' s of data dumped out. Data for the root 
nameservers is kept artificially valid if necessary. 

The first "primary" line states that the file "berkeley.edu.zone" contains authorita- 
tive data for the "Berkeley.EDU" zone. The file "berkeley.edu.zone" contains data in 
the master file format described in RFC883. All domain names are relative to the ori- 
gin, in this case, "Berkeley.EDU" (see below for a more detailed description). The 
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second "primary" line states that the file "ucbhosts.rev" contains authoritative data I 

for the domain "32.128.IN-ADDR.ARPA," which is used to translate addresses in V 

network 128.32 to hostnames. Each master file should begin with an SOA record for 
the zone (see below). 

The first "secondary" line specifies that all authoritative data under 
"CC.Berkeley.EDU" is to be transferred from the name server at 128.32.137.8. If the 
transfer fails it will try 128.32.137.3 and continue trying the addresses, up to 10, listed 
on this line. The secondary copy is also authoritative for the specified domain. The 
first non-dotted-quad address on this line will be taken as a filename in which to 
backup the transfered zone. The name server will load the zone from this backup file 
if it exists when it boots, providing a complete copy even if the master servers are 
unreachable. Whenever a new copy of the domain is received by automatic zone 
transfer from one of the master servers, this file will be updated. The second "secon- 
dary" line states that the address-to-hostname mapping for the subnet 128.32.136 
should be obtained from the same list of master servers as the previous zone. 

The "forwarders" line specifies the addresses of sitewide servers that will accept 
recursive queries from other servers. If the boot file specifies one or more forward- 
ers, then the server will send all queries for data not in the cache to the forwarders 
first. Each forwarder will be asked in turn until an answer is returned or the list is 
exhausted. If no answer is forthcoming from a forwarder, the server will continue as 
it would have without the forwarders line unless it is in "slave" mode. The forward- 
ing facility is useful to cause a large sitewide cache to be generated on a master, and 
to reduce traffic over links to outside servers. It can also be used to allow servers to 
run that do not have access directly to the Internet, but wish to act as though they do. 

The "slave" line (shown commented out) is used to put the server in slave mode. In 
this mode, the server will only make queries to forwarders. This option is normally 
used on machine that wish to run a server but for physical or administrative reasons 
cannot be given access to the Internet, but have access to a host that does have access. 

The "sortlist" line can be used to indicate networks that are to be preferred over 
other, unlisted networks. Queries for host addresses from hosts on the same network 
as the server will receive responses with local network addresses listed first, then 
addresses on the sort list, then other addresses. This line is only acted on at initial 
startup. When reloading the nameserver with a SIGHUP, this line will be ignored. 

The master file consists of control information and a list of resource records for 
objects in the zone of the forms: 

$INCLUDE <filename> <opt_domain> 

$ORIGIN <domain> 

<domain> <opt_ttl> <opt_class> <type> <resource_record_data> 

where domain is "." for root, "@" for the current origin, or a standard domain name. If 
domain is a standard domain name that does not end with ".", the current origin is 
appended to the domain. Domain names ending with "." are unmodified. The 
optjlomain field is used to define an origin for the data in an included file. It is 
equivalent to placing a $ORIGIN statement before the first line of the included file. 
The field is optional. Neither the optjlomain field nor $ORIGIN statements in the 
included file modify the current origin for this file. The optjtl field is an optional 
integer number for the time-to-live field. It defaults to zero, meaning the minimum 
value specified in the SOA record for the zone. The optjzlass field is the object 
address type; currently only one type is supported, IN, for objects connected to the 
DARPA Internet. The type field contains one of the following tokens; the data 
expected in the resource_record__data field is in parentheses. 
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NOTES 



A a host address (dotted quad) 

NS an authoritative name server (domain) 

MX a mail exchanger (domain) 

CNAME the canonical name for an alias (domain) 

SOA marks the start of a zone of authority (domain of originating host, domain 

address of maintained a serial number and the following parameters in 
seconds: refresh, retry, expire and minimum TTL (see RFC883)) 

MB a mailbox domain name (domain) 

MG a mail group member (domain) 

MR a mail rename domain name (domain) 

NULL a null resource record (no format or data) 

WKS a well know service description (not implemented yet) 

PTR a domain name pointer (domain) 

HINFO host information (cpujype OS_type) 

MINFO mailbox or mail list information (request_domain errorjiomain) 

Resource records normally end at the end of a line, but may be continued across lines 
between opening and closing parentheses. Comments are introduced by semicolons 
and continue to the end of the line. 

Each master zone file should begin with an SOA record for the zone. An example 
SOA record is as follows: 

@ IN SOA ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. ( 

2.89 ; serial 
10800 ; refresh 
3600 ; retry 
3600000; expire 
86400 ) ; minimum 

The SOA lists a serial number, which should be changed each time the master file is 
changed. Secondary servers check the serial number at intervals specified by the 
refresh time in seconds; if the serial number changes, a zone transfer will be done to 
load the new data. If a master server cannot be contacted when a refresh is due, the 
retry time specifies the interval at which refreshes should be attempted until success- 
ful. If a master server cannot be contacted within the interval given by the expire 
time, all data from the zone is discarded by secondary servers. The minimum value 
is the time-to-live used by records in the file with no explicit time-to-live value. 

The boot file directives "domain" and "suffixes" have been obsoleted by a more use- 
ful resolver based implementation of suffixing for partially qualified domain names. 
The prior mechanisms could fail under a number of situations, especially when then 
local nameserver did not have complete information. 

The following signals have the specified effect when sent to the server process using 
the killd) command. 

SIGHUP 

Causes server to read named.boot and reload database. 
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SIGINT 

Dumps current data base and cache to /usr/tmp/named_dump.db 

SIGIOT 

Dumps statistics data into /usr/tmp/named.stats if the server is compiled 
-DSTATS. Statistics data is appended to the file. 

SIGSYS 

Dumps the profiling data in /usr/tmp if the server is compiled with profiling 
(server forks, chdirs and exits). 

SIGTERM 

Dumps the primary and secondary database files. Used to save modified data 
on shutdown if the server is compiled with dynamic updating enabled. 

SIGUSR1 

Turns on debugging; each SIGUSR1 increments debug level. (SIGEMT on older 
systems without SIGUSR1 ) 

SIGUSR2 

Turns off debugging completely. (SIGFPE on older systems without SIGUSR2) 



FILES 



SEE ALSO 



c 



/etc/named.boot name server configuration boot file 

/etc/ named .pid the process id 

/usr/tmp/named.run debug output 

/usr/tmp/named__dump.db dump of the name server database 

/usr/tmp/named.stats nameserver statistics data 

kill(l), gethostbyname(3N), signal(3c), resolver(3), resolver(5), hostname(7), RFC882, 1 

RFC883, RFC973, RFC974, Name Server Operations Guide for BIND V 
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PING (8) 



ping - send ICMP ECHOJREQUEST packets to network hosts 

/etc/ping [ -r ] [ -v ] host [ packetsize ] [ count ] 

The DARPA Internet is a large and complex aggregation of network hardware, con- 
nected together by gateways. Tracking a single-point hardware or software failure 
can often be difficult, ping utilizes the ICMP protocol's mandatory ECHO_REQUEST 
datagram to elicit an ICMP ECHO_RESPONSE from a host or gateway. 
ECHOJREQUEST datagrams ("pings") have an IP and ICMP header, followed by a 
struct timeval, and then an arbitrary number of "pad" bytes used to fill out the 
packet. Default datagram length is 64 bytes, but this may be changed using the 
command-line option. Other options are: 

Bypass the normal routing tables and send directly to a host on an attached net- 
work. If the host is not on a directly-attached network, an error is returned. 
This option can be used to ping a local host through an interface that has no 
route through it (e.g., after the interface was dropped by routed(8Q). 

Verbose output. ICMP packets other than ECHO RESPONSE that are received 
are listed. 

When using ping for fault isolation, it should first be run on the local host, to verify 
that the local network interface is up and running. Then, hosts and gateways further 
and further away should be "pinged", ping sends one datagram per second, and 
prints one line of output for every ECHO_RESPONSE returned. No output is pro- 
duced if there is no response. If an optional count is given, only that number of 
requests is sent. Round-trip times and packet loss statistics are computed. When all 
responses have been received or the program times out (with a count specified), or if 
the program is terminated with a SIGINT, a brief summary is displayed. 

This program is intended for use in network testing, measurement and management. 
It should be used primarily for manual fault isolation. Because of the load it could 
impose on the network, it is unwise to use ping during normal operations or from 
automated scripts. 

Mike Muuss 
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reboot - reboot / unix 

/etc/reboot [ -n ] [ -q ] 

reboot writes out cached disk information and then requests the PROM monitor to 
reboot /unix. reboot without the -q or -n option is equivalent to 

# telinit 

The -q and -n options cause a quick reboot, no graceful shutdown is attempted. 
With either the -q or -n option specified, reboot is equivalent to 

# /etc/uadmin 2 2 

halt(8), init(lM), shutdown(8), telinit(8), uadmin(lM) 
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NAME 

SYNOPSIS 

DESCRIPTION 



DIAGNOSTICS 



BUGS 



rlogind - remote login server 

/etc/rlogind [ -d ] 

rlogind is the server for the rlogin(lC) program. The server provides a remote login 
facility with authentication based on privileged port numbers from trusted hosts. 

rlogind listens for service requests at the port indicated in the "login" service 
specification; see services(5). When a service request is received the following proto- 
col is initiated: 



1) 



2) 



The server checks the client's source port. If the port is not in the range 0-1023, 
the server aborts the connection. 



The server checks the client's source address and requests the corresponding 
host name (see gethostbyaddr (3N), hosts(5) and named(8)). If the hostname can- 
not be determined, the dot-notation representation of the host address is used. 

Once the source port and address have been checked, rlogind allocates a pseudo ter- 
minal (see pfy(4)), and manipulates file descriptors so that the slave half of the 
pseudo terminal becomes the stdin , stdout , and stderr for a login process. The login 
process is an instance of the login(l) program, invoked with the -r option. The login 
process then proceeds with the authentication process as described in rshd(8C), but if 
automatic authentication fails, it reprompts the user to login as one finds on a stan- 
dard terminal line. 

The parent of the login process manipulates the master side of the pseduo terminal, 
operating as an intermediary between the login process and the client instance of the 
rlogin program. In normal operation, the packet protocol described in pty(&) is 
invoked to provide A S/ A Q type facilities and propagate interrupt signals to the 
remote programs. The login process propagates the client terminal's baud rate and 
terminal type, as found in the environment variable, 'TERM"; see environ(7). The 
screen or window size of the terminal is requested from the client, and window size 
changes from the client are propagated to the pseudo terminal. 

All diagnostic messages are returned on the connection associated with the stderr, 
after which any network connections are closed. An error is indicated by a leading 
byte with a value of 1. 

"Try again/' 

A fork by the server failed. 

"/bin/sh: ..." 

The user's login shell could not be started. 

The authentication procedure used here assumes the integrity of each client machine 
and the connecting medium. This is insecure, but is useful in an "open" environ- 
ment. 

A facility to allow all data exchanges to be encrypted should be present. 
A more extensible protocol should be used. 
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DIAGNOSTICS 



route - manually manipulate the routing tables 

/etc/route [ -f ] [ -n ] [ command args ] 

Route is a program used to manually manipulate the network routing tables. It nor- 
mally is not needed, as the system routing table management daemon, routed (8C), 
should tend to this task. 

Route accepts two commands: add, to add a route, and delete, to delete a route. 

All commands have the following syntax: 

/etc/route command [ net I host ] destination gateway [ metric ] 

where destination is the destination host or network, gateway is the next-hop gateway 
to which packets should be addressed, and metric is a count indicating the number of 
hops to the destination. The metric is required for add commands; it must be zero if 
the destination is on a directly-attached network, and nonzero if the route utilizes 
one or more gateways. If adding a route with metric 0, the gateway given is the 
address of this host on the common network, indicating the interface to be used for 
transmission. Routes to a particular host are distinguished from those to a network 
by interpreting the Internet address associated with destination. The optional key- 
words net and host force the destination to be interpreted as a network or a host, 
respectively. Otherwise, if the destination has a "local address part" of 
INADDR_ANY, or if the destination is the symbolic name of a network, then the route 
is assumed to be to a network; otherwise, it is presumed to be a route to a host. If the 
route is to a destination connected via a gateway, the metric should be greater than 0. 
All symbolic names specified for a destination or gateway are looked up first as a host 
name using gethostbyname(3N). If this lookup fails, getnetby name (3N) is then used to 
interpret the name as that of a network. 

Route uses a raw socket and the SIOCADDRT and SIOCDELRT ioctl's to do its work. 
As such, only the super-user may modify the routing tables. 

If the -f option is specified, route will "flush" the routing tables of all gateway 
entries. If this is used in conjunction with one of the commands described above, the 
tables are flushed prior to the command's application. 

The -n option prevents attempts to print host and network names symbolically when 
reporting actions. 

"add [ host j network ] %s: gateway %s flags %x" 

The specified route is being added to the tables. The values printed are from the 
routing table entry supplied in the ioctl call. If the gateway address used was not the 
primary address of the gateway (the first one returned by gethostbyname), the gate- 
way address is printed numerically as well as symbolically. 

"delete [ host | network ] %s: gateway %s flags %x" 
As above, but when deleting an entry. 

"%s %s done" 

When the -f flag is specified, each routing table entry deleted is indicated with a mes- 
sage of this form. 

"Network is unreachable" 

An attempt to add a route failed because the gateway listed was not on a directly- 
connected network. The next-hop gateway must be given. 
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"not in table" 

A delete operation was attempted for an entry which wasn't present in the tables. 

"routing table overflow" 

An add operation was attempted, but the system was low on resources and was 
unable to allocate memory to create the new entry. 

intro(4N), routed(8C) 
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ROUTED (8C) 



routed - network routing daemon 

/etc/routed [ -d ] [ -g ] [ -s ] [ ~q ] [ -t ] [ logfile ] 

Routed is invoked at boot time to manage the network routing tables. The routing 
daemon uses a variant of the Xerox NS Routing Information Protocol in maintaining 
up to date kernel routing table entries. It used a generalized protocol capable of use 
with multiple address types, but is currently used only for Internet routing within a 
cluster of networks. 

In normal operation routed listens on the udp(4F) socket for the route service (see ser- 
vices(5)) for routing information packets. If the host is an internetwork router, it 
periodically supplies copies of its routing tables to any directly connected hosts and 
networks. 

When routed is started, it uses the SIOCGIFCONF ioctl to find those directly con- 
nected interfaces configured into the system and marked "up" (the software loop- 
back interface is ignored). If multiple interfaces are present, it is assumed that the 
host will forward packets between networks. Routed then transmits a request packet 
on each interface (using a broadcast packet if the interface supports it) and enters a 
loop, listening for request and response packets from other hosts. 

When a request packet is received, routed formulates a reply based on the information 
maintained in its internal tables. The response packet generated contains a list of 
known routes, each marked with a "hop count" metric (a count of 16, or greater, is 
considered "infinite"). The metric associated with each route returned provides a 
metric relative to the sender . 

Response packets received by routed are used to update the routing tables if one of the 
following conditions is satisfied: 

(1) No routing table entry exists for the destination network or host, and the metric 
indicates the destination is "reachable" (i.e. the hop count is not infinite). 

(2) The source host of the packet is the same as the router in the existing routing 
table entry. That is, updated information is being received from the very inter- 
network router through which packets for the destination are being routed. 

(3) The existing entry in the routing table has not been updated for some time 
(defined to be 90 seconds) and the route is at least as cost effective as the 
current route. 

(4) The new route describes a shorter route to the destination than the one 
currently stored in the routing tables; the metric of the new route is compared 
against the one stored in the table to decide this. 

When an update is applied, routed records the change in its internal tables and 
updates the kernel routing table. The change is reflected in the next response packet 
sent. 

In addition to processing incoming packets, routed also periodically checks the rout- 
ing table entries. If an entry has not been updated for 3 minutes, the entry's metric is 
set to infinity and marked for deletion. Deletions are delayed an additional 60 
seconds to insure the invalidation is propagated throughout the local internet. 

Hosts acting as internetwork routers gratuitously supply their routing tables every 
30 seconds to all directly connected hosts and networks. The response is sent to the 
broadcast address on nets capable of that function, to the destination address on 
point-to-point links, and to the router's own address on other networks. The normal 
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routing tables are bypassed when sending gratuitous responses. The reception of 
responses on each network is used to determine that the network and interface are 
functioning correctly. If no response is received on an interface, another route may 
be chosen to route around the interface, or the route may be dropped if no alternative 
is available. 

Routed supports several options: 

-d Enable additional debugging information to be logged, such as bad packets 
received. 

-g This flag is used on internetwork routers to offer a route to the "default" desti- 
nation. This is typically used on a gateway to the Internet, or on a gateway that 
uses another routing protocol whose routes are not reported to other local 
routers. 

-s Supplying this option forces routed to supply routing information whether it is 
acting as an internetwork router or not. This is the default if multiple network 
interfaces are present, or if a point-to-point link is in use. 

~q This is the opposite of the -s option. 

-t If the -t option is specified, all packets sent or received are printed on the stan- 
dard output. In addition, routed will not divorce itself from the controlling ter- 
minal so that interrupts from the keyboard will kill the process. 

Any other argument supplied is interpreted as the name of file in which routed' s 
actions should be logged. This log contains information about any changes to the 
routing tables and, if not tracing all packets, a history of recent messages sent and 
received which are related to the changed route. 

In addition to the facilities described above, routed supports the notion of "distant" 
passive and active gateways. When routed is started up, it reads the file /etc/gateways to 
find gateways which may not be located using only information from the SIOG- 
IFCONF ioctl. Gateways specified in this manner should be marked passive if they 
are not expected to exchange routing information, while gateways marked active 
should be willing to exchange routing information (i.e. they should have a routed 
process running on the machine). Passive gateways are maintained in the routing 
tables forever and information regarding their existence is included in any routing 
information transmitted. Active gateways are treated equally to network interfaces. 
Routing information is distributed to the gateway and if no routing information is 
received for a period of the time, the associated route is deleted. External gateways 
are also passive, but are not placed in the kernel routing table nor are they included 
in routing updates. The function of external entries is to inform routed that another 
routing process will install such a route, and that alternate routes to that destination 
should not be installed. Such entries are only required when both routers may learn 
of routes to the same destination. 

The /etc/ gateways is comprised of a series of lines, each in the following format: 

<net I host > nam el gateway nam e2 metric value < passive I active I external > 

The net or host keyword indicates if the route is to a network or specific host. 

Namel is the name of the destination network or host. This may be a symbolic name 
located in /etc/networks or /etc/hosts (or, if started after named (8), known to the name 
server), or an Internet address specified in "dot" notation; see inet (3N). 

Namel is the name or address of the gateway to which messages should be for- 
warded. 
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Value is a metric indicating the hop count to the destination host or network. I 

One of the keywords passive, active or external indicates if the gateway should be 
treated as passive or active (as described above), or whether the gateway is external to 
the scope of the routed protocol. 

Internetwork routers that are directly attached to the Arpanet or Milnet should use 
the Exterior Gateway Protocol (EGP) to gather routing information rather then using 
a static routing table of passive gateways. EGP is required in order to provide routes 
for local networks to the rest of the Internet system. Sites needing assistance with 
such configurations should contact the Computer Systems Research Group at Berke- 
ley. 



FILES 
SEE ALSO 
BUGS 



/etc/gateways for distant gateways 

"Internet Transport Protocols", XSIS 028112, Xerox System Integration Standard. 

The kernel's routing tables may not correspond to those of routed when redirects 
change or add routes. The only remedy for this is to place the routing process in the 
kernel. 

Routed should incorporate other routing protocols, such as Xerox NS 
(XNSrouted (8C)) and EGP. Using separate processes for each requires configuration 
options to avoid redundant or competing routes. 

Routed should listen to intelligent interfaces, such as an IMP, and to error protocols, 

such as ICMP, to gather more information. It does not always detect unidirectional ^ 

failures in network interfaces (e.g., when the output side fails). I 
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rshd - remote shell server 



/etc/rshd 



rshd is the server for the rcmd(3X) routine and, consequently, for the rsh(lC) pro- 
gram. The server provides remote execution facilities with authentication based on 
privileged port numbers from trusted hosts. 

rshd listens for service requests at the port indicated in the "cmd" service 
specification; see services (5). When a service request is received the following proto- 
col is initiated: 

1) The server checks the client's source port. If the port is not in the range 0-1023, 
the server aborts the connection. 

2) The server reads characters from the socket up to a null ('\0') byte. The resul- 
tant string is interpreted as an ASCII number, base 10. 

3) If the number received in step 1 is non-zero, it is interpreted as the port number 
of a secondary stream to be used for the stderr. A second connection is then 
created to the specified port on the client's machine. The source port of this 
second connection is also in the range 0-1023. 

4) The server checks the client's source address and requests the corresponding 
host name (see geihostbyaddr (3N), hosts(5) and named(8)). If the hostname can- 
not be determined, the dot-notation representation of the host address is used. 

5) A null terminated user name of at most 16 characters is retrieved on the initial 
socket. This user name is interpreted as the user identity on the client's 
machine. 

6) A null terminated user name of at most 16 characters is retrieved on the initial 
socket. This user name is interpreted as a user identity to use on the server's 
machine. 

7) A null terminated command to be passed to a shell is retrieved on the initial 
socket. The length of the command is limited by the upper bound on the size of 
the system's argument list. 

8) rshd then validates the user according to the following steps. The local (server- 
end) user name is looked up in the password file and a chdir is performed to the 
user's home directory. If either the lookup or chdir fail, the connection is ter- 
minated. If the user is not the super-user, (user id 0), the file / etc/hosts. equiv is 
consulted for a list of hosts considered "equivalent". If the client's host name is 
present in this file, the authentication is considered successful. If the lookup 
fails, or the user is the super-user, then the file .rhosts in the home directory of 
the remote user is checked for the machine name and identity of the user on the 
client's machine. If this lookup fails, the connection is terminated. 

9) A null byte is returned on the initial socket and the command line is passed to 
the normal login shell of the user. The shell inherits the network connections 
established by rshd . 

Except for the last one listed below, all diagnostic messages are returned on the ini- 
tial socket, after which any network connections are closed. An error is indicated by 
a leading byte with a value of 1 (0 is returned in step 9 above upon successful com- 
pletion of all the steps prior to the execution of the login shell). 
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"locuser too long" 

The name of the user on the client's machine is longer than 16 characters. 

"remuser too long" 

The name of the user on the remote machine is longer than 16 characters. 

"command too long " 

The command line passed exceeds the size of the argument list (as configured into 

the system). 

"Login incorrect." 

No password file entry for the user name existed. 

"No remote directory." 

The chdir command to the home directory failed. 

"Permission denied." 

The authentication procedure described above failed. 

"Can't make pipe." 

The pipe needed for the stderr, wasn't created. 

"Try again." 

A fork by the server failed. 

"<shellname>: ..." 

The user's login shell could not be started. This message is returned on the connec- 
tion associated with the stderr, and is not preceded by a flag byte. 

rsh(lC) 

The authentication procedure used here assumes the integrity of each client machine 
and the connecting medium. This is insecure, but is useful in an "open" environ- 
ment. 

A facility to allow all data exchanges to be encrypted should be present. 

A more extensible protocol should be used. 
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rwhod - system status server 

/etc/rwhod 

rwhod is the server which maintains the database used by the rwho(lC) and 
rupHme(lC) programs. Its operation is predicated on the ability to broadcast messages 
on a network. 

rwhod operates as both a producer and consumer of status information. As a pro- 
ducer of information it periodically queries the state of the system and constructs 
status messages which are broadcast on a network. As a consumer of information, it 
listens for other rwhod servers' status messages, validating them, then recording them 
in a collection of files located in the directory /usr/spool/rwho . 

The server transmits and receives messages at the port indicated in the "rwho" ser- 
vice specification; see services (5). The messages sent and received, are of the form: 

struct outmp { 

char outJine[8];/* tty name */ 
char out_name[8];/* user id .*/ 
long outjime;/ * time on * / 

}; 

struct whod { 



char 


wd_vers; 


char 


wd type; 


char 


wd_fill[2]; 


int 


wd_sendtime; 


int 


wd_recvtime; 


char 


wd_ho s tname [32] ; 


int 


wd_loadav[3]; 


int 


wd_boottime; 


struct 


whoent { 




struct outmp we_utmp; 




int we_idle; 


} wd_we[1024 / sizeof (struct whoent)]; 



}; 

All fields are converted to network byte order prior to transmission. The load aver- 
ages are as calculated by the w(l) program, and represent load averages over the 5, 
10, and 15 minute intervals prior to a server's transmission; they are multiplied by 
100 for representation in an integer. The host name included is that returned by the 
gethostname(2) system call, with any trailing domain name omitted. The array at the 
end of the message contains information about the users logged in to the sending 
machine. This information includes the contents of the utmp(5) entry for each non- 
idle terminal line and a value indicating the time in seconds since a character was last 
received on the terminal line. 

Messages received by the rwho server are discarded unless they originated at an rwho 
server's port. In addition, if the host's name, as specified in the message, contains 
any unprintable ASCII characters, the message is discarded. Valid messages received 
by rwhod are placed in files named whod .hostname in the directory /usr/spool/rwho. 
These files contain only the most recent message, in the format described above. 
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Status messages are generated approximately once every 3 minutes. § 

SEE ALSO 

rwho(lC), ruptime(lC) 

BUGS 

There should be a way to relay status information between networks. Status informa- 
tion should be sent only upon request rather than continuously. People often inter- 
pret the server dying or network communtication failures as a machine going down. 



( 



C 
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sendmail - send mail over the internet 

/usr/lib/sendmail [ flags ] [ address ... ] 

newaliases 

mailq [ -v ] 

Sendmail sends a message to one or more recipients, routing the message over what- 
ever networks are necessary. Sendmail does internetwork forwarding as necessary to 
deliver the message to the correct place. 

Sendmail is not intended as a user interface routine; other programs provide user- 
friendly front ends; sendmail is used only to deliver pre-formatted messages. 

With no flags, sendmail reads its standard input up to an end-of-file or a line consist- 
ing only of a single dot and sends a copy of the message found there to all of the 
addresses listed. It determines the network(s) to use based on the syntax and con- 
tents of the addresses. 

Local addresses are looked up in a file and aliased appropriately. Aliasing can be 
prevented by preceding the address with a backslash. Normally the sender is not 
included in any alias expansions, e.g., if 'John' sends to 'group 7 , and 'group' includes 
'john' in the expansion, then the letter will not be delivered to 'John'. 

Flags are: 

-ba Go into ARPANET mode. All input lines must end with a CR-LF, 

and all messages will be generated with a CR-LF at the end. 
Also, the "From:" and "Sender:" fields are examined for the 
name of the sender. 

-bd Run as a daemon. This requires Berkeley IPC. Sendmail will fork 

and run in background listening on socket 25 for incoming SMTP 
connections. This is normally run from /etc/rc. 

-bi Initialize the alias database. 

-bm Deliver mail in the usual way (default). 

-bp Print a listing of the queue. 

-bs Use the SMTP protocol as described in RFC821 on standard input 

and output. This flag implies all the operations of the -ba flag 
that are compatible with SMTP. 

-bt Run in address test mode. This mode reads addresses and shows 

the steps in parsing; it is used for debugging configuration tables. 

-bv Verify names only - do not try to collect or deliver a message. 

Verify mode is normally used for validating users or mailing lists. 

-bz Create the configuration freeze file. 

-Cfile Use alternate configuration file. Sendmail refuses to run as root if 

an alternate configuration file is specified. The frozen 
configuration file is bypassed. 

-dX Set debugging value to X. 

-Vfullname Set the full name of the sender. 
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-iname 



-hN 



-n 

-ox value 
-qltime] 



-mame 
-t 



There are also a 
only be used by- 
line using the -o 

Afile 



dx 



ex 



Fmode 
f 



SENDMAIL(8) 

Sets the name of the "from" person (i.e., the sender of the mail). 
-f can only be used by "trusted" users (normally root daemon, 
and network) or if the person you are trying to become is the same 
as the person you are. 

Set the hop count to N. The hop count is incremented every time 
the mail is processed. When it reaches a limit, the mail is 
returned with an error message, the victim of an aliasing loop. If 
not specified, "Received:" lines in the message are counted. 

Don't do aliasing. 

Set option x to the specified value. Options are described below. 

Processed saved messages in the queue at given intervals. If time 
is omitted, process the queue once. Time is given as a tagged 
number, with V being seconds, 'm' being minutes, 'h' being 
hours, 'd' being days, and 'w' being weeks. For example, 
"-qlh30m" or "-q90m" would both set the timeout to one hour 
thirty minutes. If time is specified, sendmail will run in back- 
ground. This option can be used safely with -bd. 

An alternate and obsolete form of the -f flag. 

Read message for recipients. To:, Cc:, and Bcc: lines will be 
scanned for recipient addresses. The Bcc: line will be deleted 
before transmission. Any addresses in the argument list will be 
suppressed, that is, they will not receive copies even if listed in 
the message header. 

Go into verbose mode. Alias expansions will be announced, etc. 

number of processing options that may be set. Normally these will 
a system administrator. Options may be set either on the command 
flag or in the configuration file. The options are: 

Use alternate alias file. 

On mailers that are considered "expensive" to connect to, don't 
initiate immediate connection. This requires queueing. 

Set the delivery mode to x. Delivery modes are 'i' for interactive 
(synchronous) delivery, 'b' for background (asynchronous) 
delivery, and 'q' for queue only - i.e., actual delivery is done the 
next time the queue is run. 

Try to automatically rebuild the alias database if necessary. 

Set error processing to mode x. Valid modes are 'm' to mail back 
the error message, V to "write" back the error message (or mail 
it back if the sender is not logged in), 'p' to print the errors on the 
terminal (default), 'q' to throw away error messages (only exit 
status is returned), and 'e' to do special processing for the Berk- 
Net. If the text of the message is not mailed back by modes 'm' or 
'w' and if the sender is local to this machine, a copy of the mes- 
sage is appended to the file "dead.letter" in the sender's home 
directory. 

The mode to use when creating temporary files. 

Save UNIX-style From lines at the front of messages. 



( 



c 
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Hfile 

i 

Ln 

m 

o 



Qqueuedir 
rtimeout 



Sfile 
s 

Ttime 

tstz,dtz 
uN 



The default group id to use when calling mailers. 

The SMTP help file. 

Do not take dots on a line by themselves as a message terminator. 

The log level. 

Send to "me" (the sender) also if I am in an alias expansion. 

If set, this message may have old style headers. If not set, this 
message is guaranteed to have new style headers (i.e., commas 
instead of spaces between addresses). If set, an adaptive algo- 
rithm is used that will correctly determine the header format in 
most cases. 

Select the directory in which to queue messages. 

The timeout on reads; if none is set, sendmail will wait forever for 
a mailer. This option violates the word (if not the intent) of the 
SMTP specification, show the timeout should probably be fairly 
large. 

Save statistics in the named file. 

Always instantiate the queue file, even under circumstances 
where it is not strictly necessary. This provides safety against 
system crashes during delivery. 

Set the timeout on undelivered messages in the queue to the 
specified time. After delivery has failed (e.g., because of a host 
being down) for this amount of time, failed messages will be 
returned to the sender. The default is three days. 

Set the name of the time zone. 

Set the default user id for mailers. 



In aliases, the first character of a name may be a vertical bar to cause interpretation of 
the rest of the name as a command to pipe the mail to. It may be necessary to quote 
the name to keep sendmail from suppressing the blanks from between arguments. 
For example, a common alias is: 

msgs: " I /usr/ucb/msgs -s" 

Aliases may also have the syntax ":mclude:filename" to ask sendmail to read the 
named file for a list of recipients. For example, an alias such as: 

poets: ":include:/usr/local/lib/poets.list u 

would read /usr/local/lib/poets.list for the list of addresses making up the group. 

Sendmail returns an exit status describing what it did. The codes are defined in 
<sysexits.h> 

Successful completion on all addresses. 

User name not recognized. 

Catchall meaning necessary resources were not available. 

Syntax error in address. 

Internal software error, including bad arguments. 

Temporary operating system error, such as "cannot 

fork". 

Host name not recognized. 

Message could not be sent immediately, but was queued. 



EX_OK 

EX_NOUSER 

EXJJNAVAILABLE 

EX_SYNTAX 

EX_SOFTWARE 

EXJDSERR 

EX_NOHOST 
EX TEMPFAIL 



Stardent 1500/3000 



47 



^NotvvorKin^^^Buooor^^JMtllrtios^ 



SENDMAIL(8) SENDMA!L(8) 

If invoked as newaliases, sendmail will rebuild the alias database. If invoked as mailq, f 

sendmail will print the contents of the mail queue. 

FILES 

Except for /usr/lib/sendmail.cf, these pathnames are all specified in 
/usr/lib/sendmail.cf. Thus, these values are only approximations. 

/usr/lib/aliases raw data for alias names 
/usr/lib/aliases.pag 

/usr/lib/aliases.dir data base of alias names 

/usr/lib/sendmail.cf configuration file 

/usr/lib/sendmail.fc frozen configuration 

/usr/lib/sendmail.hf help file 

/usr/lib/sendmail.st collected statistics 

/usr/spool/mqueue/* temp files 

SEE ALSO 

mail(l), mailx(l), rmail(l), syslog(3), aliases(4), sendmail.cf(4), mailaddr(5) 
System Administrator's Guide 



c 



( 
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syslogd - log systems messages 

/etc/syslogd [ -iconfigfile ] [ -mmarMnterval ] [ -d ] 

Syslogd reads and logs messages into a set of files described by the configuration file 
/etc/syslog.conf. Each message is one line. A message can contain a priority code, 
marked by a number in angle braces at the beginning of the line. Priorities are 
defined in <sys/syslog.h>. Syslogd reads from the UNIX domain socket /dev/log, from 
an Internet domain socket specified in /etc/services, and from the special device 
/dev/klog (to read kernel messages). 

Syslogd configures when it starts up and whenever it receives a hangup signal. Lines 
in the configuration file have a selector to determine the message priorities to which 
the line applies and an action. The action field are separated from the selector by one 
or more tabs. 

Selectors are semicolon separated lists of priority specifiers. Each priority has a facil- 
ity describing the part of the system that generated the message, a dot, and a level 
indicating the severity of the message. Symbolic names may be used. An asterisk 
selects all facilities. All messages of the specified level or higher (greater severity) are 
selected. More than one facility may be selected using commas to separate them. For 
example: 

* .emerg;mail,daemon.crit 

Selects all facilities at the emerg level and the mail and daemon facilities at the crit level. 

Known facilities and levels recognized by syslogd are those listed in syslogO) without 
the leading "LOG_". The additional facility "mark" has a message at priority 
LOGJNFO sent to it every 20 minutes (this may be changed with the -m flag). The 
"mark" facility is not enabled by a facility field containing an asterisk. The level 
"none" may be used to disable a particular facility. For example, 

* .debug;mail.none 

Sends all messages except mail messages to the selected file. 

The second part of each line describes where the message is to be logged if this line is 
selected. There are four forms: 

• A filename (beginning with a leading slash). The file will be opened in append 
mode. 

• A hostname preceeded by an at sign ("@"). Selected messages are forwarded to 
the syslogd on the named host. 

• A comma separated list of users. Selected messages are written to those users if 
they are logged in. 

• An asterisk. Selected messages are written to all logged-in users. 
Blank lines and lines beginning with '#' are ignored. 

For example, the configuration file: 

kern,mark.debug /dev/console 

*.notice;mail.info /usr/spool/adm/syslog 

*.crit /usr/adm/ critical 

kern.err ©ucbarpa 

*. emerg * 

*. alert eric,kridle 
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*.alert;auth. warning ralph 

logs all kernel messages and 20 minute marks onto the system console, all notice (or 
higher) level messages and all mail system messages except debug messages into the 
file /usr/spool/adm/syslog, and all critical messages into /usr/adm/critical; kernel 
messages of error severity or higher are forwarded to ucbarpa. All users will be 
informed of any emergency messages, the users "eric" and "kridle" will be informed 
of any alert messages, and the user "ralph" will be informed of any alert message, or 
any warning message (or higher) from the authorization system. 

The flags are: 

-f Specify an alternate configuration file. 

-m Select the number of minutes between mark messages. 

-d Turn on debugging. 

Syslogd creates the file /etc/syslog.pid, if possible, containing a single line with its 
process id. This can be used to kill or reconfigure syslogd. 

To bring syslogd down, it should be sent a terminate signal (e.g. kill "cat 
/etc/syslog.pid v ). 



FILES 



SEE ALSO 



/etc/ syslog.conf the configuration file 

/etc/syslog.pid the process id 

/dev/log Name of the UNIX domain datagram log socket 

/dev/klog The kernel log device 

logger (1), syslog(3) 



c 
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telnetd - DARPA TELNET protocol server 

/etc/telnetd 

telnetd is a server which supports the DARPA standard TELNET virtual terminal 
protocol, telnetd is invoked by the internet server (see inetd(8)), normally for requests 
to connect to the TELNET port as indicated by the /etc/services file (see services(5)). 

telnetd operates by allocating a pseudo-terminal device (see ph/(4)) for a client, then 
creating a login process which has the slave side of the pseudo-terminal as stdin, 
stdout, and stderr. telnetd manipulates the master side of the pseudo-terminal, 
implementing the TELNET protocol and passing characters between the remote 
client and the login process. 

When a TELNET session is started up, telnetd sends TELNET options to the client 
side indicating a willingness to do remote echo of characters, to suppress go ahead, and 
to receive terminal type information from the remote client. If the remote client is wil- 
ling, the remote terminal type is propagated in the environment of the created login 
process. The pseudo-terminal allocated to the client is configured to operate in 
"cooked" mode, and with XTABS and CRMOD enabled (see %(4)). 

telnetd is willing to do: echo, binary, suppress go ahead, and timing mark, telnetd is wil- 
ling to have the remote client do: binary, terminal type, and suppress go ahead. 

telnet(lC) 

Some TELNET commands are only partially implemented. 

The TELNET protocol allows for the exchange of the number of lines and columns 
or the user's terminal, but telnetd doesn't make use of them. 

Because of bugs in the original 4.2 BSD telnetdO, telnetd performs some dubious 
protocol exchanges to try to discover if the remote client is, in fact, a 4.2 BSD 

telnet{\C). 

Binary mode has no common interpretation except between similar operating systems 
(Unix in this case). 

The terminal type name received from the remote client is converted to lower case. 

The packet interface to the pseudo-terminal (see pty(4d) should be used for more intel- 
ligent flushing of input and output queues. 

telnetd never sends TELNET go ahead commands. 
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zic - time zone compiler 

zic [ -v ] [ -d directory ] [ -1 localtime] [ -L leapsecondfilename ] [ -s ] [ filename ... ] 

Zic reads text from the file(s) named on the command line and creates the time 
conversion information files specified in this input. If a filename is -, the standard 
input is read. 

These options are available: 

-d directory 

Create time conversion information files in the named directory rather than in 
the standard directory named below. 

-1 timezone 

Use the given time zone as local time. Zic will act as if the file contained a link 
line of the form 



Link timezone 



localtime 



-v 



-s 



-L leapsecondfilename 

Read leap second information from the file with the given name. If this option 
is not used, leap second information is read from a file named "leapseconds". 

Complain if a year that appears in a data file is outside the range of years 
representable by time(2) values. 

Limit time values stored in output files to values that are the same whether 
they're taken to be signed or unsigned. You can use this option to generate 
SVVS-compatible files. 

Input lines are made up of fields. Fields are separated from one another by any 
number of white space characters. Leading and trailing white space on input 
lines is ignored. An unquoted sharp character (#) in the input introduces a 
comment which extends to the end of the line the sharp character appears on. 
White space characters and sharp characters may be enclosed in double quotes 
(") if they're to be used as part of a field. Any line that is blank (after comment 
stripping) is ignored. Non-blank lines are expected to be of one of three types: 
rule lines, zone lines, and link lines. 

A rule line has the form 



Rule NAME FROM TO TYPE IN ON 



AT SAVE LETTER/S 



For example: 

Rule USA 



1969 



1973 - 



Apr lastSun 2:00 1:00 D 



The fields that make up a rule line are: 

NAME Gives the (arbitrary) name of the set of rules this rule is part of. 

FROM Gives the first year in which the rule applies. The word minimum (or an 
abbreviation) means the minimum year with a representable time value. 
The word maximum (or an abbreviation) means the maximum year with 
a representable time value. 



c 
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TO Gives the final year in which the rule applies. In addition to minimum 

and maximum (as above), the word only (or an abbreviation) may be 
used to repeat the value of the FROM field. 

TYPE Gives the type of year in which the rule applies. If TYPE is - then the rule 
applies in all years between FROM and TO inclusive; if TYPE is uspres, 
the rule applies in U.S. Presidential election years; if TYPE is nonpres, the 
rule applies in years other than U.S. Presidential election years. If TYPE is 
something else, then zic executes the command 

yearistype year type 
to check the type of a year: an exit status of zero is taken to mean that the 
year is of the given type; an exit status of one is taken to mean that the 
year is not of the given type. 

IN Names the month in which the rule takes effect. Month names may be 

abbreviated. 

ON Gives the day on which the rule takes effect. Recognized forms include: 

5 the fifth of the month 

lastSun the last Sunday in the month 

lastMon the last Monday in the month 

Sun>=8 first Sunday on or after the eighth 

Sun<=25 last Sunday on or before the 25th 

Names of days of the week may be abbreviated or spelled out in full. 
Note that there must be no spaces within the ON field. 

AT Gives the time of day at which the rule takes effect. Recognized forms 

include: 

2 time in hours 

2:00 time in hours and minutes 

15:00 24-hour format time (for times after noon) 

1:28:14 time in hours, minutes, and seconds 

Any of these forms may be followed by the letter w if the given time is 
local "wall clock" time or s if the given time is local "standard" time; in 
the absence of w or s, wall clock time is assumed. 

SAVE Gives the amount of time to be added to local standard time when the rule 
is in effect. This field has the same format as the AT field (although, of 
course, the w and s suffixes are not used). 

LETTER/S 

Gives the "variable part" (for example, the "S" or "D" in "EST" or 
"EDT") of time zone abbreviations to be used when this rule is in effect. If 
this field is -, the variable part is null. 

A zone line has the form 

Zone NAME GMTOFF RULES/SAVE FORMAT [UNTIL] 

For example: 

Zone Australia/South-west 9:30 Aus CST 1987 Mar 15 2:00 

The fields that make up a zone line are: 
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NAME The name of the time zone. This is the name used in creating the time 
conversion information file for the zone. 

GMTOFF 

The amount of time to add to GMT to get standard time in this zone. This 
field has the same format as the AT and SAVE fields of rule lines; begin the 
field with a minus sign if time must be subtracted from GMT. 

RULES/SAVE 

The name of the rule(s) that apply in the time zone or, alternately, an 
amount of time to add to local standard time. If this field is - then standard 
time always applies in the time zone. 

FORMAT 

The format for time zone abbreviations in this time zone. The pair of char- 
acters % sis used to show where the ''variable part 7 ' of the time zone abbre- 
viation goes. 

UNTIL The time at which the GMT offset or the rule(s) change for a location. It is 
specified as a year, a month, a day, and a time of day. If this is specified, 
the time zone information is generated from the given GMT offset and rule 
change until the time specified. 

The next line must be a "continuation" line; this has the same form as a 
zone line except that the string "Zone" and the name are omitted, as the 
continuation line will place information starting at the time specified as the 
UNTIL field in the previous line in the file used by the previous line. Con- 
tinuation lines may contain an UNTIL field, just as zone lines do, indicating 
that the next line is a further continuation. 

A link line has the form 

Link L1NK-FROM LINK-TO 
Forexample: 

Link US/Eastern EST5EDT 

The LINK-FROM field should appear as the NAME field in some zone line; the 
LINK-TO field is used as an alternate name for that zone. 

Except for continuation lines, lines may appear in any order in the input. 

Lines in the file that describes leap seconds have the following form: 
Leap YEAR MONTH DAY HH:MM:SS CORR R/S 

Forexample: 

Leap 1974 Dec 31 23:59:60 + S 

The YEAR, MONTH, DAY, and HH:MM:SS fields tell when the leap second hap- 
pened. The CORR field should be "+" if a second was added or "-" if a second was 
skipped. The R/S field should be (an abbreviaton of) "Stationary" if the leap second 
time given by the other fields should be interpreted as GMT or (an abbreviation of) 
"Rolling" if the leap second time given by the other fields should be interpreted as 
local wall clock time. 
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NOTE 

For areas with more than two types of local time, you may need to use local standard 
time in the AT field of the earliest transition time's rule to ensure that the earliest 
transition time recorded in the compiled file is correct. 



FILES 



/etc/zoneinfo standard directory used for created files leapseconds default 
leap second information file 



SEE ALSO 

ctime(3), zdump(8) 
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